home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / imail110.zip / IMAIL.DOC < prev    next >
Text File  |  1991-02-10  |  181KB  |  5,121 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                   ╒═══════════════════════════════════════════╕
  19.                   │                                           │
  20.                   │                 I M A I L                 │
  21.                   │                                           │
  22.                   │                                           │
  23.                   │    The "Semi-Intuitive" Mail Processor    │
  24.                   │                                           │
  25.                   │                                           │
  26.                   │                                           │
  27.                   │               Version 1.10                │
  28.                   │                                           │
  29.                   ╘═══════════════════════════════════════════╛
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                      Copyright 1990, 1991 by Fabiano Fabris
  37.                              for Intuition Software
  38.  
  39.                                All Rights Reserved
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                                   Dedicated to
  51.                                  Marco Manzocco
  52.                             and all the beta testers
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  67.     └─────────────────────────────────────────────────────────────────────┘
  68.  
  69.  
  70.  
  71.  
  72.                              ══ TABLE OF CONTENTS ══
  73.  
  74.  
  75.     1. INTRODUCTION .................................................... 1
  76.  
  77.     2. WARRANTY AND REGISTRATION INFORMATION ........................... 2
  78.  
  79.     3. ACKNOWLEDGEMENTS ................................................ 4
  80.        a. Copyrights ................................................... 4
  81.  
  82.     4. INSTALLATION .................................................... 5
  83.        a. System Requirements .......................................... 5
  84.           1) Hardware .................................................. 5
  85.           2) Software .................................................. 5
  86.           3) Networks .................................................. 6
  87.  
  88.     5. IMSETUP ......................................................... 7
  89.        a. General Configuration ........................................ 7
  90.           1) System Addresses .......................................... 7
  91.           2) Domain Names .............................................. 8
  92.           3) Subdirectories ............................................ 8
  93.              - QBBS/RA System .......................................... 9
  94.              - Net Mail Message ........................................ 9
  95.              - Inbound Net Files ....................................... 9
  96.              - Outbound Net Files ...................................... 9
  97.              - IMAIL Log File Name ..................................... 9
  98.              - Echo Stats Log File ..................................... 10
  99.              - Log Level ............................................... 10
  100.              - Net Mail Board .......................................... 10
  101.              - Bad Message Board ....................................... 11
  102.              - Dupe Message Board ...................................... 11
  103.           4) AreaLink Options .......................................... 11
  104.              - Keep AreaLink Receipt ................................... 12
  105.              - Allow Rescan Request .................................... 12
  106.              - Forward Link Requests (R) ............................... 12
  107.           5) Other Parameters .......................................... 13
  108.              - No Net Mail Forward ..................................... 13
  109.              - Check Bad Message Board ................................. 13
  110.              - Kill Empty Messages ..................................... 14
  111.              - ARCmail 0.6 Compatibility ............................... 14
  112.              - Max Packet Size (R) ..................................... 14
  113.              - Kill Messages to 0/0 (R) ................................ 14
  114.              - Single Bundle Extract (R) ............................... 14
  115.              - Save Remapped Mail (R) .................................. 15
  116.              - Send Return Receipt (R) ................................. 15
  117.              - Automatic Message Replies (R) ........................... 15
  118.              - Sysop Name .............................................. 16
  119.        b. Compression Programs ......................................... 16
  120.        c. Decompression Programs ....................................... 16
  121.        d. Echo Areas ................................................... 17
  122.           1) Editing Keys .............................................. 17
  123.  
  124.  
  125.  
  126.  
  127.     ┌─────────────────────────────────────────────────────────────────────┐
  128.     └── (C) Fabiano Fabris ────────────────────────────────────────── i ──┘
  129.  
  130.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  131.     └─────────────────────────────────────────────────────────────────────┘
  132.  
  133.  
  134.  
  135.  
  136.              - F1: Edit ................................................ 17
  137.              - F2: Find ................................................ 17
  138.              - F3: Global .............................................. 18
  139.              - Ins: Add ................................................ 18
  140.              - Del: Delete ............................................. 18
  141.              - Home: First ............................................. 18
  142.              - End: Last ............................................... 18
  143.              - ESC: Exit ............................................... 18
  144.              - PgUp/PgDn: Previous/Next ................................ 19
  145.           2) The Echo Area Record ...................................... 19
  146.              - Area Name ............................................... 19
  147.              - Active .................................................. 19
  148.              - Comment ................................................. 19
  149.              - Origin Line ............................................. 20
  150.              - Board ................................................... 20
  151.              - Passthrough ............................................. 20
  152.              - Secure .................................................. 20
  153.              - # Days .................................................. 21
  154.              - Group ................................................... 21
  155.              - Tiny-Seens .............................................. 21
  156.              - Keep-Seens .............................................. 21
  157.              - # Msgs .................................................. 22
  158.              - XRS (R) ................................................. 22
  159.              - Origin Address .......................................... 22
  160.              - Seen-Bys ................................................ 22
  161.              - Export List ............................................. 23
  162.        e. Node Export Manager .......................................... 23
  163.           1) Address ................................................... 23
  164.           2) Password .................................................. 23
  165.           3) Groups .................................................... 23
  166.           4) Direct .................................................... 24
  167.           5) Remote Maint (R) .......................................... 24
  168.           6) Status .................................................... 24
  169.           7) Program ................................................... 24
  170.           8) Capability ................................................ 25
  171.        f. Pack Routing ................................................. 25
  172.        g. Import/Export ................................................ 26
  173.           1) Import Areas.Bbs .......................................... 26
  174.           2) Export Areas Config (R) ................................... 27
  175.           3) Create Areas.Bbs File (R) ................................. 28
  176.           4) Export Group List (R) ..................................... 28
  177.           5) Export Nodes Config (R) ................................... 28
  178.  
  179.     6. IMAIL COMMAND LINE OPTIONS ...................................... 29
  180.        a. /? - Help .................................................... 29
  181.        b. TOSS - Toss Incoming Mail .................................... 29
  182.           1) /B - Check Bad Message Board .............................. 30
  183.           2) /N - No AreaLink .......................................... 30
  184.        c. SCAN - Scan for Outgoing Mail ................................ 30
  185.           1) /N - No default pack routing .............................. 31
  186.  
  187.  
  188.  
  189.  
  190.  
  191.     ┌─────────────────────────────────────────────────────────────────────┐
  192.     └── (C) Fabiano Fabris ───────────────────────────────────────── ii ──┘
  193.  
  194.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  195.     └─────────────────────────────────────────────────────────────────────┘
  196.  
  197.  
  198.  
  199.  
  200.        d. PACK - Pack Net Mail Messages ................................ 31
  201.           1) /N - No default pack routing .............................. 33
  202.           2) /C - Pack Crash Messages .................................. 33
  203.           3) /H - Pack Hold Messages ................................... 33
  204.           4) /? - Help ................................................. 33
  205.        e. ALNK - AreaLink .............................................. 34
  206.        f. Other Information ............................................ 34
  207.           1) Packet Compression ........................................ 34
  208.           2) New Echo Areas ............................................ 34
  209.  
  210.     7. AREALINK ........................................................ 35
  211.        a. Format of the Request ........................................ 35
  212.        b. Meta-Commands ................................................ 36
  213.           1) %ALL ...................................................... 36
  214.           2) %FROM (R) ................................................. 37
  215.           3) %LIST ..................................................... 37
  216.           4) %QUERY .................................................... 37
  217.           5) %RESCAN ................................................... 37
  218.        c. AreaLink Replies ............................................. 38
  219.        d. Forward Link Requests (R) .................................... 38
  220.  
  221.     8. AUTOMATIC MESSAGE REPLIES (R) ................................... 39
  222.        a. %of% ......................................................... 39
  223.        b. %ol% ......................................................... 39
  224.        c. %os% ......................................................... 39
  225.        d. %df% ......................................................... 39
  226.        e. %dl% ......................................................... 39
  227.        f. %ds% ......................................................... 39
  228.        g. %mt% ......................................................... 40
  229.        h. %md% ......................................................... 40
  230.        i. %at% ......................................................... 40
  231.        j. %ad% ......................................................... 40
  232.        k. %dy% ......................................................... 40
  233.        l. %im% ......................................................... 40
  234.  
  235.     9. IMTHINGS ........................................................ 41
  236.        a. EXPORT - Export Net Mail Messages ............................ 41
  237.        b. IMPORT - Import Net Mail Messages ............................ 42
  238.        c. INDEX - Rebuild index files .................................. 42
  239.        d. KILL - Delete messages from an area .......................... 42
  240.           1) /A<areaname> .............................................. 43
  241.           2) /B<board> ................................................. 43
  242.           3) /D<days> .................................................. 43
  243.           4) /N<number> ................................................ 43
  244.           5) /O - PACK with Overwrite .................................. 44
  245.           6) /P - Run PACK after KILL .................................. 44
  246.           7) /U - Use Default Information .............................. 44
  247.        e. LINK - Link Messages in Message Base ......................... 44
  248.        f. MOVE - Move Message Area ..................................... 45
  249.           1) /SA<src area> ............................................. 45
  250.  
  251.  
  252.  
  253.  
  254.  
  255.     ┌─────────────────────────────────────────────────────────────────────┐
  256.     └── (C) Fabiano Fabris ──────────────────────────────────────── iii ──┘
  257.  
  258.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  259.     └─────────────────────────────────────────────────────────────────────┘
  260.  
  261.  
  262.  
  263.  
  264.           2) /SB<src board> ............................................ 46
  265.           3) /DA<dst area> ............................................. 46
  266.           4) /DB<dst board> ............................................ 46
  267.        g. NOTIFY - Send list of linked echos ........................... 46
  268.        h. PACK - Compress message base ................................. 46
  269.           1) /B - Keep backup .......................................... 47
  270.           2) /C - Check for cross-linked message ....................... 47
  271.           3) /O - Overwrite ............................................ 47
  272.           4) /R - Renumber ............................................. 47
  273.        i. POST - Post message in echo area ............................. 47
  274.           1) /F<filename> .............................................. 48
  275.           2) /A<areaname> .............................................. 48
  276.           3) /B<board> ................................................. 48
  277.           4) /W<to_who> ................................................ 48
  278.           5) /S<subject> ............................................... 48
  279.        j. RECOVER (R) - Unerase messages ............................... 49
  280.           1) /A<areaname> .............................................. 49
  281.           2) /B<board> ................................................. 49
  282.           3) /U - Automatic Mode ....................................... 49
  283.        k. SEND (R) - Send a file ....................................... 49
  284.           1) /F<filename> .............................................. 50
  285.           2) /A<address> ............................................... 50
  286.           3) /W<to_who> ................................................ 50
  287.           4) /T<text> .................................................. 51
  288.           5) /C - Crash ................................................ 51
  289.           6) /H - Hold ................................................. 51
  290.           7) /D - Direct ............................................... 51
  291.           8) /K - Kill/Sent ............................................ 51
  292.           9) /E - Delete/Sent .......................................... 51
  293.           10) /Y<days> - Newer than .................................... 52
  294.           11) /1-10 - Alternate AKA .................................... 52
  295.        l. SORT - Sort the Message Base ................................. 52
  296.        m. STAT - Generate Statistics Report ............................ 52
  297.           1) /K - Keep Statistics Information .......................... 52
  298.  
  299.     10. AN OVERVIEW OF ECHOMAIL ........................................ 54
  300.        a. What is Echo Mail? ........................................... 54
  301.        b. How it Works ................................................. 54
  302.        c. Echo Mail Message Control Information ........................ 55
  303.           1) Area Line ................................................. 55
  304.           2) Tear Line ................................................. 55
  305.           3) Origin Line ............................................... 56
  306.           4) SEEN-BY Lines ............................................. 56
  307.           5) PATH Lines ................................................ 56
  308.        d. Methods of Sending Echo Mail ................................. 57
  309.        e. Topology ..................................................... 57
  310.        f. Why a PATH line? ............................................. 59
  311.        g. Gating of Echo Mail .......................................... 59
  312.  
  313.     11. KLUDGE LINES USED BY IMAIL ..................................... 61
  314.  
  315.  
  316.  
  317.  
  318.  
  319.     ┌─────────────────────────────────────────────────────────────────────┐
  320.     └── (C) Fabiano Fabris ───────────────────────────────────────── iv ──┘
  321.  
  322.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  323.     └─────────────────────────────────────────────────────────────────────┘
  324.  
  325.  
  326.  
  327.  
  328.        a. INTL ......................................................... 61
  329.        b. TOPT ......................................................... 61
  330.        c. FMPT ......................................................... 62
  331.        d. EID .......................................................... 62
  332.        e. MSGID ........................................................ 62
  333.        f. REPLY ........................................................ 63
  334.        g. PID .......................................................... 63
  335.        h. FLAGS ........................................................ 63
  336.           1) DIR ....................................................... 63
  337.           2) IMM ....................................................... 64
  338.           3) TFS ....................................................... 64
  339.           4) KFS ....................................................... 64
  340.           5) CFM ....................................................... 64
  341.           6) RRQ ....................................................... 64
  342.  
  343.     12. BATCH FILE EXAMPLE ............................................. 66
  344.  
  345.     13. MISCELLANEOUS INFORMATION ...................................... 68
  346.        a. Files Maintained by IMAIL .................................... 68
  347.        b. Exit Codes ................................................... 69
  348.  
  349.     14. IMAIL DISTRIBUTION SITES ....................................... 70
  350.        a. Registration Sites ........................................... 70
  351.           1) Headquarters .............................................. 70
  352.           2) Europe .................................................... 70
  353.           3) North America ............................................. 70
  354.        b. Support Sites ................................................ 71
  355.           1) Austria ................................................... 71
  356.           2) Sweden .................................................... 71
  357.           3) Switzerland ............................................... 71
  358.           4) U.S.A. .................................................... 71
  359.  
  360.         INDEX .......................................................... 72
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.     ┌─────────────────────────────────────────────────────────────────────┐
  384.     └── (C) Fabiano Fabris ────────────────────────────────────────── v ──┘
  385.  
  386.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  387.     └─────────────────────────────────────────────────────────────────────┘
  388.  
  389.  
  390.  
  391.  
  392.      1. INTRODUCTION
  393.  
  394.         IMAIL is a FTSC-compatible echo mail processor and net mail message
  395.         bundler written for QuickBBS  or RemoteAccess and fully  compatible
  396.         BBS software. Since it is also a message packer, is does away  with
  397.         the  need  for  such  programs  as  oMMM,  which  are  NOT  FidoNet
  398.         compatible. Rather,  IMAIL  uses  the technique  of  creating  file
  399.         attach messages  for  outgoing mail.  Net  mail messages  are  also
  400.         packed, a possibility not generally available to QuickBBS systems.
  401.  
  402.         It also features full Zone and Point support, eliminating the  need
  403.         to use the "fake address" method of sending mail to and from points
  404.         (IMAIL does however have limited support for point net addressing).
  405.  
  406.         If you  are new  to  FidoNet-type mail  processing, I  suggest  you
  407.         familiarize yourself with the documentation for the mailer you will
  408.         be using, and read "An Overview of Echomail", Chapter 10.
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.     ┌─────────────────────────────────────────────────────────────────────┐
  448.     └── (C) Fabiano Fabris ────────────────────────────────────────── 1 ──┘
  449.  
  450.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  451.     └─────────────────────────────────────────────────────────────────────┘
  452.  
  453.  
  454.  
  455.  
  456.      2. WARRANTY AND REGISTRATION INFORMATION
  457.  
  458.         IMAIL is distributed as ShareWare. This means that you are free  to
  459.         distribute this program to  anyone you like, as  long as you  don't
  460.         charge for it, modify the program in  any way, or add files to  the
  461.         original distribution archives.
  462.  
  463.         IMAIL may be used freely without registration in non-commercial and
  464.         non-governmental sites.  Commercial  and  governmental  sites  MUST
  465.         register the program if they  intend to continue using the  program
  466.         after a trial period of THIRTY (30) days.
  467.  
  468.         Registration is valid  for all  versions of the  program; you  only
  469.         need to  register once.  It will  enable the  advanced features  of
  470.         IMAIL, and give  me incentive  to continue  development... so  that
  471.         little feature you suggested can be implemented!  :-)
  472.  
  473.         The base  registration  cost  is $50.00  US.  For  specific  rates,
  474.         contact the  registration site  closest to  you, the  addresses  of
  475.         which appear in Chapter  14. Section a. When  you register, send  a
  476.         cheque or money  order to  the registration  site, and  a net  mail
  477.         message with your name  as it appears in  the IMSETUP screen,  your
  478.         postal address, and one of the network addresses you have  defined.
  479.         This is important, because  the key you receive  will be locked  on
  480.         your name and the network address you supply.
  481.  
  482.         When the registration fee is received, you shall be sent a net mail
  483.         message to which  your key will  be attached. The  name of the  key
  484.         file you will  receive will resemble  154BD7A9.KEY; rename this  to
  485.         IMAIL.KEY and copy it to the directory from which you run IMAIL, or
  486.         to the directory pointed to by the IMAIL environment variable. This
  487.         will enable the advanced features of  IMAIL. The key will be  valid
  488.         for all versions of IMAIL, future and past.
  489.  
  490.         IMAIL is in  no way a  crippled program, nor  will it stop  working
  491.         after a  certain amount  of time.  I didn't  like this  concept  in
  492.         ShareWare  programs.   So  instead,   some  extra   features   were
  493.         implemented which  would  only work  in  registered copies  of  the
  494.         program.
  495.  
  496.         This program  is only  guaranteed to  take up  disk space,  nothing
  497.         else. In other words, if it  breaks itself or your system, you  own
  498.         both parts. However, I will do  my utmost to fix any bugs  reported
  499.         to me, ask long as  I have enough information to  do so. Due to  my
  500.         work load, I can only guarantee support to registered users.
  501.  
  502.         OK, 'nuf said. Time  to get on with  the serious stuff. But  before
  503.         closing: bug reports and comments should be addressed to:
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.     ┌─────────────────────────────────────────────────────────────────────┐
  512.     └── (C) Fabiano Fabris ────────────────────────────────────────── 2 ──┘
  513.  
  514.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  515.     └─────────────────────────────────────────────────────────────────────┘
  516.  
  517.  
  518.  
  519.  
  520.            Fabiano Fabris
  521.            Via Zardini 19
  522.            33090 Sequals (PN)
  523.            Italy
  524.  
  525.            SIGnet    27:27/0  or  27:1339/103
  526.            FidoNet   2:230/41.22
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.     ┌─────────────────────────────────────────────────────────────────────┐
  576.     └── (C) Fabiano Fabris ────────────────────────────────────────── 3 ──┘
  577.  
  578.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  579.     └─────────────────────────────────────────────────────────────────────┘
  580.  
  581.  
  582.  
  583.  
  584.      3. ACKNOWLEDGEMENTS
  585.  
  586.         This program is dedicated to  Marco Manzocco, a very close  friend,
  587.         without whose support IMAIL would never have been written.
  588.  
  589.         IMSETUP makes use of  the C eXtended Library  (CXL) version 5.2  by
  590.         Mike Smedley.
  591.  
  592.         My deepest gratitude to  my Beta Testers,  who risked seeing  their
  593.         message base grunged  by my  program, and for  having had  patience
  594.         when I released buggy beta  versions (a few horrible examples  come
  595.         to mind). I could never have done it without them!
  596.  
  597.         Very special thanks to:
  598.  
  599.            Harry   Dijkstra,   Jimmy   Hansen,   Henk   Heidema,    Joaquim
  600.            Homrighausen,   Mark   Howard,    Maurice   Leeflang,    Andreas
  601.            Levenitschnig, Luca Leone, Tom McGivern.
  602.  
  603.  
  604.         a. Copyrights
  605.  
  606.            These  programs  are  mentioned   in  this  document,  and   are
  607.            copyrighted as follows:
  608.  
  609.               D'Bridge                      Chris Irwin
  610.               FrontDoor                     Joaquim Homrighausen
  611.               oMMM                          Wymm Wagner III
  612.               QuickBBS                      Richard Creighton &
  613.                                             Steve Grabilowitz
  614.               RemoteAccess                  Andrew Milner
  615.               Scottex Toilet Paper          Scott Corp.
  616.               TosScan                       Joaquim Homrighausen
  617.               XRS                           Mike Ratledge
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.     ┌─────────────────────────────────────────────────────────────────────┐
  640.     └── (C) Fabiano Fabris ────────────────────────────────────────── 4 ──┘
  641.  
  642.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  643.     └─────────────────────────────────────────────────────────────────────┘
  644.  
  645.  
  646.  
  647.  
  648.      4. INSTALLATION
  649.  
  650.         IMAIL is supplied in a single compressed file which should  contain
  651.         the following files:
  652.  
  653.            IMAIL.EXE            The executable file
  654.  
  655.            IMSETUP.EXE          The setup program
  656.  
  657.            IMTHINGS.EXE         The external utilities
  658.  
  659.            IMAIL.DOC            The documentation
  660.  
  661.            CHANGES.DOC          Changes since the last release
  662.  
  663.            IM_REPLY.TXT         Sample text to use with the Automatic
  664.                                 reply function
  665.  
  666.            REGISTER.FRM         A registration form  which may be  imported
  667.                                 into a net mail message
  668.  
  669.         Copy the two executable files to the same directory (which might be
  670.         the same directory from which you run QuickBBS or RemoteAccess) and
  671.         run IMSETUP.
  672.  
  673.         Should you  want  IMAIL to  look  for its  configuration  files  in
  674.         another subdirectory, set the  environment variable IMAIL to  point
  675.         to it. For example:
  676.  
  677.            SET IMAIL=C:\IMAIL
  678.  
  679.  
  680.         a. System Requirements
  681.  
  682.  
  683.            1) Hardware
  684.  
  685.               IBM PC/AT/386, or fully compatible
  686.               Mono or color display
  687.               Hard disk
  688.  
  689.  
  690.            2) Software
  691.  
  692.               MS-DOS (or PC-DOS) 3.10 or greater
  693.               A message editor which supports the QuickBBS message format
  694.               An FTSC-0001 compatible  mailer
  695.               One or more compression programs, selected from:
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.     ┌─────────────────────────────────────────────────────────────────────┐
  704.     └── (C) Fabiano Fabris ────────────────────────────────────────── 5 ──┘
  705.  
  706.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  707.     └─────────────────────────────────────────────────────────────────────┘
  708.  
  709.  
  710.  
  711.  
  712.                  ARC by System Enhancement Associates;
  713.                  LHarc by Haruyasu Yoshizaki;
  714.                  PKARC/PKPAK by PKWARE Inc.;
  715.                  PAK by NoGate Consulting;
  716.                  PKZip by PKWARE Inc.;
  717.                  ZOO by Rhaul Dhesi.
  718.  
  719.  
  720.            3) Networks
  721.  
  722.                  WARNING!!!  This version of IMAIL has not been tested with
  723.                  any networking software!  If you run  Novell or any  other
  724.                  network, you do so at your own risk!
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.     ┌─────────────────────────────────────────────────────────────────────┐
  768.     └── (C) Fabiano Fabris ────────────────────────────────────────── 6 ──┘
  769.  
  770.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  771.     └─────────────────────────────────────────────────────────────────────┘
  772.  
  773.  
  774.  
  775.  
  776.      5. IMSETUP
  777.  
  778.         The program IMSETUP is used  to configure the various options  used
  779.         by IMAIL. Some of these may be omitted, and some are available only
  780.         to registered users.
  781.  
  782.         In this chapter, each  option will be  examined in detail.  Options
  783.         available only to registered users are indicated with an (R).
  784.  
  785.         IMSETUP can be  given one  or more command  line options,  selected
  786.         from the following:
  787.  
  788.            /M    Force 'mono' color set
  789.            /C    Force 'color' color set
  790.            /D    Force direct screen writes
  791.            /S    Force CGA snow elimination
  792.  
  793.         Naturally, /D and /S have exactly opposite effects, so it makes  no
  794.         sense to use them together.
  795.  
  796.         Note: Should  you  wish  IMSETUP  to create  and/or  look  for  the
  797.         configuration files in a directory which is different from the  one
  798.         in which you ran it, set the IMAIL environment variable to point to
  799.         this directory.  Otherwise, IMSETUP  will create  in files  in  the
  800.         current working directory.
  801.  
  802.  
  803.         a. General Configuration
  804.  
  805.            This  options  leads  to  another  menu  which  allows   various
  806.            system-wide parameters  to be  set. Please  follow through  this
  807.            section carefully!
  808.  
  809.  
  810.            1) System Addresses
  811.  
  812.               The "System Addresses"  menu allows  you to define  up to  11
  813.               network addresses and fakenet  addresses. The first of  these
  814.               is your primary  address. It should  be the same  as the  one
  815.               defined as your primary in your mailer and/or BBS program.
  816.  
  817.               The  other  addresses  given  are  your  system's  AKAs   (or
  818.               aliases).
  819.  
  820.               Addresses should be given in the form:
  821.  
  822.                  zone:net/node.point
  823.  
  824.               The point field may be omitted, in which case it will default
  825.               to 0.
  826.  
  827.  
  828.  
  829.  
  830.  
  831.     ┌─────────────────────────────────────────────────────────────────────┐
  832.     └── (C) Fabiano Fabris ────────────────────────────────────────── 7 ──┘
  833.  
  834.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  835.     └─────────────────────────────────────────────────────────────────────┘
  836.  
  837.  
  838.  
  839.  
  840.               Addresses may be  in different zones,  and even in  different
  841.               domains (or networks).
  842.  
  843.               At least the primary address must be specified.
  844.  
  845.               Fakenets are used in situations  where you are exporting  net
  846.               mail to points  which do  not support full  4D addresses.  In
  847.               such cases,  you will  need to  define a  "fake net  number".
  848.               IMAIL will use these numbers as follows:
  849.  
  850.               If your address  is 27:1339/103,  and you have  a fakenet  of
  851.               21339, mail  addressed to  27:21339/10  will be  remapped  to
  852.               27:1339/103.10 before being sent on.
  853.  
  854.               You need only use fakenet numbers  if you are a boss  system;
  855.               if you are a  point, there is no  need for this, since  IMAIL
  856.               will correctly handle the point number.
  857.  
  858.               IMAIL uses  these  fakenet  numbers  to  readdress  net  mail
  859.               messages to the correct point system, as well as to eliminate
  860.               them from outgoing  echo mail  (both during TOSS  as well  as
  861.               SCAN).
  862.  
  863.  
  864.            2) Domain Names
  865.  
  866.               In this menu are specified the domain(s) to which you belong.
  867.               The word "domain"  is used to  distinguish between  different
  868.               amateur networks such as SIGnet and FidoNet.
  869.  
  870.               Here, you  should  indicate  the zone  number(s)  and  domain
  871.               name(s) of which you  are a part. If  this is the first  time
  872.               you are running it, IMSETUP will supply as default the  zones
  873.               and domain names for SIGnet and FidoNet. You need not  define
  874.               all the zones for a given domain, just those relevant to your
  875.               geographical area.
  876.  
  877.               IMAIL uses this information for MSGID kludges when generating
  878.               net mail messages (AreaLink or the AutoReply feature).
  879.  
  880.               If you are  in doubt of  which zone you  belong to, or  which
  881.               domain, please contact your nearest Coordinator or Host.
  882.  
  883.  
  884.            3) Subdirectories
  885.  
  886.               In this menu, specify  the paths to  the various files  IMAIL
  887.               needs to  use  during  execution.  Most  of  the  fields  are
  888.               required.
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.     ┌─────────────────────────────────────────────────────────────────────┐
  896.     └── (C) Fabiano Fabris ────────────────────────────────────────── 8 ──┘
  897.  
  898.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  899.     └─────────────────────────────────────────────────────────────────────┘
  900.  
  901.  
  902.  
  903.  
  904.               When specifying  subdirectories, you  may omit  the  trailing
  905.               backslash.
  906.  
  907.  
  908.               - QBBS/RA System
  909.  
  910.                 Specify the path  to the QuickBBS  or RemoteAccess  message
  911.                 base files.  These  message  base files  are  searched  for
  912.                 outgoing messages when you run the IMAIL SCAN function. For
  913.                 example:
  914.  
  915.                    C:\QBBS
  916.  
  917.                 This field is required.
  918.  
  919.  
  920.               - Net Mail Message
  921.  
  922.                    The path  to  where  your mailer  stores  its  net  mail
  923.                    messages (*.MSG). IMAIL will use this when searching for
  924.                    existent file attaches,  or when  it generates  outgoing
  925.                    net mail of its own.
  926.  
  927.                    This field is required.
  928.  
  929.  
  930.               - Inbound Net Files
  931.  
  932.                 This is where  your mailer stores  inbound compressed  mail
  933.                 files and packets. IMAIL  will look here  when you run  the
  934.                 TOSS function.
  935.  
  936.                 This field is required.
  937.  
  938.  
  939.               - Outbound Net Files
  940.  
  941.                 This subdirectory is where  your mailer normally looks  for
  942.                 outbound compresses files. These files may be generated  by
  943.                 all of IMAIL's functions.
  944.  
  945.                 This field is required.
  946.  
  947.  
  948.               - IMAIL Log File Name
  949.  
  950.                 Is you wish  IMAIL to  log its  activity to  file, you  may
  951.                 specify the name  of the log  file here. It  should be  the
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.     ┌─────────────────────────────────────────────────────────────────────┐
  960.     └── (C) Fabiano Fabris ────────────────────────────────────────── 9 ──┘
  961.  
  962.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  963.     └─────────────────────────────────────────────────────────────────────┘
  964.  
  965.  
  966.  
  967.  
  968.                 complete path  and name  of  the file.  If  a path  is  not
  969.                 specified, the file will be written to the current  working
  970.                 directory.
  971.  
  972.  
  973.               - Echo Stats Log File
  974.  
  975.                 IMTHINGS,  the  supplementary  utilities  for  IMAIL,   can
  976.                 generate a statistics file containing information about how
  977.                 much echo mail  has passed  through your  system (TOSS  and
  978.                 SCAN combined). If you wish to generate this file,  specify
  979.                 the path and name of the file here. If the path is omitted,
  980.                 the file will be written to the current working  directory.
  981.                 (For more information  on how  to generate  this file,  see
  982.                 Chapter 9.)
  983.  
  984.  
  985.               - Log Level
  986.  
  987.                 If you have specified that IMAIL should create a log  file,
  988.                 here you may indicate how  much information you wish to  be
  989.                 written to the log file.
  990.  
  991.                 There are three possible choices:
  992.  
  993.                    0: Normal.  This will  log only  important  information,
  994.                    errors and final stats to the log.
  995.  
  996.                    1:  Verbose.  Complete   information  will  be   logged,
  997.                    including all echo areas scanned or tossed.
  998.  
  999.                    2: FrontDoor.  This will  create a  log file  compatible
  1000.                    with  the  format  used  by  FrontDoor.  The  amount  of
  1001.                    information  written,  however,  is  the  same  as   for
  1002.                    "Normal"
  1003.  
  1004.  
  1005.               - Net Mail Board
  1006.  
  1007.                 IMAIL will scan  this board  number for  outgoing net  mail
  1008.                 messages. However,  incoming  net  mail  messages  will  be
  1009.                 written to the Net Mail Message subdirectory as MSG files.
  1010.  
  1011.                 This field is required.
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.     ┌─────────────────────────────────────────────────────────────────────┐
  1024.     └── (C) Fabiano Fabris ───────────────────────────────────────── 10 ──┘
  1025.  
  1026.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  1027.     └─────────────────────────────────────────────────────────────────────┘
  1028.  
  1029.  
  1030.  
  1031.  
  1032.               - Bad Message Board
  1033.  
  1034.                 Messages flagged as "bad" will be tossed into this  message
  1035.                 board. These  include  echo  mail  messages  arriving  from
  1036.                 unlisted systems  when "Secure"  mode  is active  for  that
  1037.                 area, as well as echo in unrecognized areas.
  1038.  
  1039.                 In registered versions of the program, IMAIL will  generate
  1040.                 a message to the sysop stating that unrecognized echo  mail
  1041.                 has been  received.  It  will also  create  a  file  called
  1042.                 IMAIL.NE. IMSETUP will  look for this  file, and if  found,
  1043.                 ask if  you  wish  to  add the  new  areas.  If  you  reply
  1044.                 affirmatively, IMSETUP will  create the  areas. (Note  that
  1045.                 you will still need to enter the Area Manager to define the
  1046.                 board number and the group).
  1047.  
  1048.                 This field is required.
  1049.  
  1050.  
  1051.               - Dupe Message Board
  1052.  
  1053.                 This message  board  is the  one  into which  all  messages
  1054.                 flagged as duplicates will be tossed. It may be the same as
  1055.                 the one  defined a  Bad  Message Board  (see above),  or  a
  1056.                 different board.  If  not  defined, dupes  will  simply  be
  1057.                 killed (deleted).
  1058.  
  1059.  
  1060.            4) AreaLink Options
  1061.  
  1062.               The options in this menu regard IMAIL's area manager,  called
  1063.               AREALINK. This function will do  for IMAIL what AreaFix  does
  1064.               for other systems.
  1065.  
  1066.               Your downlinks will be able to request that new areas be sent
  1067.               to them, or that areas no longer be sent. Besides this,  they
  1068.               may request information on which echos are available to them,
  1069.               and have a list of the echos they are currently receiving. In
  1070.               registered copies of IMAIL,  AreaLink can also request  areas
  1071.               not no your system from your uplinks, thus further automating
  1072.               your system.
  1073.  
  1074.               For information on how AreaLink is used, see Chapter 7.
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.     ┌─────────────────────────────────────────────────────────────────────┐
  1088.     └── (C) Fabiano Fabris ───────────────────────────────────────── 11 ──┘
  1089.  
  1090.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  1091.     └─────────────────────────────────────────────────────────────────────┘
  1092.  
  1093.  
  1094.  
  1095.  
  1096.               - Keep AreaLink Receipt
  1097.  
  1098.                 If you enable this option (set it to 'Y'), then IMAIL  will
  1099.                 not mark  its  outgoing  messages as  KILL/SENT.  In  other
  1100.                 words, once the message  has been sent,  it will remain  in
  1101.                 your net mail directory for you to see it.
  1102.  
  1103.  
  1104.               - Allow Rescan Request
  1105.  
  1106.                 If enabled,  AreaLink will  honour requests  to rescan  the
  1107.                 message base for a particular echo. For more information on
  1108.                 how the rescan may be requested, see Chapter 7. Section b.
  1109.  
  1110.                 If this  option is  set  to "N",  rescan requests  will  be
  1111.                 ignored.
  1112.  
  1113.  
  1114.               - Forward Link Requests (R)
  1115.  
  1116.                 Forward  Link  Requests   are  a  method   to  have   IMAIL
  1117.                 automatically request  areas  from your  echo  uplinks.  If
  1118.                 AreaLink processes a request for an echo area which is  not
  1119.                 listed in your configuration, it will search the files  you
  1120.                 have defined  for  this area.  If  found, it  will  send  a
  1121.                 request for that area to the system listed. See Chapter  7.
  1122.                 section d. for more information.
  1123.  
  1124.                 In the "Uplink" column, specify the network address of  the
  1125.                 system to  which the  request should  be sent.  The  "Areas
  1126.                 file" column indicates the file  name of an AREAS.BBS  type
  1127.                 file containing the  list of echo  areas available on  that
  1128.                 system.
  1129.  
  1130.                 In the "Send To" column,  indicate the name of the  program
  1131.                 to which  a request  should be  sent. For  systems  running
  1132.                 IMAIL, this would be AREALINK; for systems running TosScan,
  1133.                 specify  AREAMGR.  In  the  "Password"  column,  write  the
  1134.                 password the uplink has assigned you for his area manager.
  1135.  
  1136.                 The format of the AREAS.BBS file  is the same as that  used
  1137.                 by most programs, and recognized by the "Import  Areas.Bbs"
  1138.                 function in IMSETUP. Each line is composed of three fields.
  1139.                 The first is  a board  number or a  subdirectory name,  and
  1140.                 must be present in order for IMAIL to correctly extract the
  1141.                 information it needs. The second  field is the name of  the
  1142.                 echo area. The third field is the list of export addresses;
  1143.                 this field is  not required. Note  that IMAIL will  discard
  1144.                 the first line of the file, as well as any beginning with a
  1145.                 semi-colon (';').
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.     ┌─────────────────────────────────────────────────────────────────────┐
  1152.     └── (C) Fabiano Fabris ───────────────────────────────────────── 12 ──┘
  1153.  
  1154.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  1155.     └─────────────────────────────────────────────────────────────────────┘
  1156.  
  1157.  
  1158.  
  1159.  
  1160.            5) Other Parameters
  1161.  
  1162.               This menu is a "catch all" for various options which  control
  1163.               how IMAIL operates.
  1164.  
  1165.               Most of the options  available are of  the "on/off" type;  in
  1166.               other words, specifying 'Y' will enable the option, while 'N'
  1167.               will disable it.
  1168.  
  1169.               Options available to registered users only will not be  shown
  1170.               to unregistered users.
  1171.  
  1172.  
  1173.               - No Net Mail Forward
  1174.  
  1175.                 If this option  is enabled,  your system  will not  forward
  1176.                 mail for ANY  system. This includes  net mail messages,  or
  1177.                 routed files.
  1178.  
  1179.                 For a routed file attach, the file will simply be  renamed;
  1180.                 for a routed net mail  message, the message will be  tossed
  1181.                 into your Bad Message Board.
  1182.  
  1183.                 If your  are  a  registered user,  IMAIL  will  generate  a
  1184.                 warning message to the sender of the routed mail.
  1185.  
  1186.  
  1187.               - Check Bad Message Board
  1188.  
  1189.                 If this option is active, IMAIL will check the Bad  Message
  1190.                 Board for echo mail which might have been considered  "bad"
  1191.                 during the previous  run. If  found, the  messages will  be
  1192.                 moved into the correct echo mail board.
  1193.  
  1194.                 Use this option  if you  expect to receive  new echo  areas
  1195.                 without warning; once you have  added them to your list  of
  1196.                 areas, you can have IMAIL scan for the messages which would
  1197.                 otherwise "sit" in your Bad Message Board.
  1198.  
  1199.                 Please note that echo mail which is re-imported using  this
  1200.                 method cannot be exported. The reason for this is that  the
  1201.                 messages might easily create duplicates.
  1202.  
  1203.                 If you set this option off,  it may still be overridden  by
  1204.                 using the /B switch with IMAIL TOSS (see Chapter 6. section
  1205.                 b.).
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.     ┌─────────────────────────────────────────────────────────────────────┐
  1216.     └── (C) Fabiano Fabris ───────────────────────────────────────── 13 ──┘
  1217.  
  1218.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  1219.     └─────────────────────────────────────────────────────────────────────┘
  1220.  
  1221.  
  1222.  
  1223.  
  1224.               - Kill Empty Messages
  1225.  
  1226.                 Enabling this option causes IMAIL to kill (delete) messages
  1227.                 with no content.
  1228.  
  1229.  
  1230.               - ARCmail 0.6 Compatibility
  1231.  
  1232.                 If this option is set, IMAIL will generate compressed  mail
  1233.                 bundles that  conform to  the ARCmail  0.6 naming  standard
  1234.                 when sending  to  systems marked  in  the node  manager  as
  1235.                 "Stone Age", or to systems not listed in the node  manager.
  1236.                 Systems listed  as "Type  2+" will  have a  special  naming
  1237.                 scheme. (See Chapter 5. section  e. for information on  the
  1238.                 Capability Word).
  1239.  
  1240.                 If this is set to "No", then IMAIL will always use its  own
  1241.                 internal method  for  the  naming  of  outbound  compressed
  1242.                 files.
  1243.  
  1244.                 Note that the  setting of  this flag will  be ignored  when
  1245.                 IMAIL generates ARCmail to point addresses.
  1246.  
  1247.  
  1248.               - Max Packet Size (R)
  1249.  
  1250.                 With this option, you can  specify the maximum size of  the
  1251.                 packet files (*.PKT)  that IMAIL will  create. Use this  if
  1252.                 your up- and/or down links are short on disk space.
  1253.  
  1254.                 The number should indicate a  size in kilobytes. If a  zero
  1255.                 (0) is specified, there will be no limit imposed.
  1256.  
  1257.  
  1258.               - Kill Messages to 0/0 (R)
  1259.  
  1260.                 If this option  is enabled, IMAIL  will automatically  kill
  1261.                 (delete) incoming messages addresses to 0/0.
  1262.  
  1263.                 This was added because some mailers have the nasty habit of
  1264.                 generating such messages for reasons of their own.
  1265.  
  1266.  
  1267.               - Single Bundle Extract (R)
  1268.  
  1269.                 When enabled,  IMAIL  will try  to  extract one  bundle  or
  1270.                 packet at a time from compressed mail files.
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.     ┌─────────────────────────────────────────────────────────────────────┐ 
  1280.     └── (C) Fabiano Fabris ───────────────────────────────────────── 14 ──┘
  1281.  
  1282.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐ 
  1283.     └─────────────────────────────────────────────────────────────────────┘
  1284.  
  1285.  
  1286.  
  1287.  
  1288.                 This option should be used only on systems where disk space
  1289.                 is tight, because it  will slow down  the execution of  the
  1290.                 program noticeably.
  1291.  
  1292.                 Currently, this option will extract the packets in a single
  1293.                 compressed file before processing, but it will extract  ALL
  1294.                 the packets. In  a future  version, IMAIL will  be able  to
  1295.                 extract a single packet  from the compressed file,  process
  1296.                 it and then go on to the next. However, I need the internal
  1297.                 structures of LZH and ZOO files in order to do this.
  1298.  
  1299.  
  1300.               - Save Remapped Mail (R)
  1301.  
  1302.                 When mail is remapped, a copy of the message will be  saved
  1303.                 when this option is enabled.
  1304.  
  1305.                 Mail is remapped  automatically when it  is addressed to  a
  1306.                 point of your system.
  1307.  
  1308.  
  1309.               - Send Return Receipt (R)
  1310.  
  1311.                 If a net  mail messages  arrives with  the "Request  Return
  1312.                 Receipt" flag set, IMAIL will automatically generate a  net
  1313.                 mail message to  the originating system,  stating that  the
  1314.                 message arrived.
  1315.  
  1316.                 Note that the FLAGS RRQ kludge is not supported by IMAIL in
  1317.                 the  current  version.  Since  the  message  attribute   is
  1318.                 defined, I decided to support it.
  1319.  
  1320.  
  1321.               - Automatic Message Replies (R)
  1322.  
  1323.                 IMAIL can generate automatic replies  to net mail that  has
  1324.                 been sitting in your Net  Mail directory for longer than  a
  1325.                 specified period.
  1326.  
  1327.                 Specifying a  number of  days  will activate  this  option.
  1328.                 IMAIL will scan  your Net  Mail Directory  for unread  mail
  1329.                 addressed to your  system, which  is older  than the  given
  1330.                 number of days.
  1331.  
  1332.                 If you activate this option, you may also specify the  path
  1333.                 and name of a text file to send as a reply.
  1334.  
  1335.                 For more information, see Chapter 8.
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.     ┌─────────────────────────────────────────────────────────────────────┐ 
  1344.     └── (C) Fabiano Fabris ───────────────────────────────────────── 15 ──┘
  1345.  
  1346.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐ 
  1347.     └─────────────────────────────────────────────────────────────────────┘
  1348.  
  1349.  
  1350.  
  1351.  
  1352.               - Sysop Name
  1353.  
  1354.                 This field is  required, as  it is  used by  IMAIL for  the
  1355.                 generation of automatic messages and so on. IMAIL also uses
  1356.                 it to validate your registration key file.
  1357.  
  1358.                 For information of how to register IMAIL, see Chapter 2.
  1359.  
  1360.  
  1361.         b. Compression Programs
  1362.  
  1363.            In this section, you may specify the programs, along with  their
  1364.            parameters, to use in the creation of outbound compressed mail.
  1365.  
  1366.            When you run IMSETUP for the  first time, it will show  defaults
  1367.            for the following programs:
  1368.  
  1369.               ARC by System Enhancement Associates;
  1370.               LHarc by Haruyasu Yoshizaki;
  1371.               PKARC/PKPAK by PKWARE Inc.;
  1372.               PAK by NoGate Consulting;
  1373.               PKZip by PKWARE Inc.;
  1374.               ZOO by Rhaul Dhesi.
  1375.  
  1376.            If you wish, you may add  other programs of your own choice,  or
  1377.            delete those you do not intend to use.
  1378.  
  1379.            Of course, all of the programs you intend to use must be present
  1380.            somewhere in the DOS path.
  1381.  
  1382.            You will then  select which of  these programs to  use for  mail
  1383.            compression on a  per-system basis, in  the Node Export  Manager
  1384.            (see Section e.). If IMAIL needs  to compress mail for a  system
  1385.            not listed, it will use the first of those given in this menu.
  1386.  
  1387.  
  1388.         c. Decompression Programs
  1389.  
  1390.            IMAIL automagically recognizes compressed files produced by  the
  1391.            following programs:
  1392.  
  1393.               ARC by System Enhancement Associates;
  1394.               LHarc by Haruyasu Yoshizaki;
  1395.               PKARC/PKPAK by PKWARE Inc.;
  1396.               PAK by NoGate Consulting;
  1397.               PKZip by PKWARE Inc.;
  1398.               ZOO by Rhaul Dhesi.
  1399.  
  1400.            In this menu, you may change the name and parameters which  will
  1401.            be executed when compressed mail files are identified.
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.     ┌─────────────────────────────────────────────────────────────────────┐ 
  1408.     └── (C) Fabiano Fabris ───────────────────────────────────────── 16 ──┘
  1409.  
  1410.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐ 
  1411.     └─────────────────────────────────────────────────────────────────────┘
  1412.  
  1413.  
  1414.  
  1415.  
  1416.            Be VERY careful when changing  these items, for a mistake  might
  1417.            produce  very  unexpected  (and  often  unwanted)  results.  And
  1418.            certainly do NOT try  to use one program  instead of another.  A
  1419.            compressed file identified as having been created by LHarc,  for
  1420.            example, cannot be decompressed by ARC!
  1421.  
  1422.            If possible, have all of the decompression programs somewhere in
  1423.            the DOS path, unless  you are absolutely  certain that you  will
  1424.            not be getting mail compressed by one or more of them.
  1425.  
  1426.  
  1427.         d. Echo Areas
  1428.  
  1429.            The echo area manager is one of the most important parts of  the
  1430.            program, and also controls most of what IMAIL does.
  1431.  
  1432.            When you first run IMSETUP, no echo areas are defined. You  will
  1433.            see a screen  with many different  fields, all empty  or set  to
  1434.            certain default  values. These  fields will  be explained  in  a
  1435.            moment, but first the editing keys.
  1436.  
  1437.            Note: Registered users  who are  changing over  from other  mail
  1438.            processors  may  prefer  to  import  their  existing  echo  area
  1439.            configuration information. See Chapter 5. section g.
  1440.  
  1441.  
  1442.            1) Editing Keys
  1443.  
  1444.               The following keys  will allow  you to edit,  add, delete  or
  1445.               find echo area records. They are:
  1446.  
  1447.  
  1448.               - F1: Edit
  1449.  
  1450.                 The F1 key allows you to edit the current echo area  record
  1451.                 (ie the one currently being displayed). For the meaning  of
  1452.                 each of the fields, see below.
  1453.  
  1454.                 If at any  time during  editing you wish  to abort,  simply
  1455.                 press ESC, and nothing will be  saved. The same is true  if
  1456.                 you were adding an area: it will be "forgotten".
  1457.  
  1458.  
  1459.               - F2: Find
  1460.  
  1461.                 Pressing F2 brings up a window in which you may specify  an
  1462.                 area name. If the area is  found, it will be displayed;  if
  1463.                 not, the area which most  closely matches the required  one
  1464.                 will be displayed. It may then be edited with F1.
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.     ┌─────────────────────────────────────────────────────────────────────┐ 
  1472.     └── (C) Fabiano Fabris ───────────────────────────────────────── 17 ──┘
  1473.  
  1474.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐ 
  1475.     └─────────────────────────────────────────────────────────────────────┘
  1476.  
  1477.  
  1478.  
  1479.  
  1480.               - F3: Global
  1481.  
  1482.                 If you  need  to  make  global changes  to  the  echo  area
  1483.                 information, pressing  F3 will  bring  up the  Global  Edit
  1484.                 menu. From this, it is  possible to edit the origin  lines,
  1485.                 origin addresses, or to add,  delete or replace systems  in
  1486.                 the export list.
  1487.  
  1488.                 In each  case, the  changes  will be  made on  a  per-group
  1489.                 basis. One  or  more  groups  may  be  specified,  and  the
  1490.                 modifications will be made for all echo areas which  belong
  1491.                 to the selected groups.
  1492.  
  1493.                 To close  the Global  Edit  menu, press  ESC; you  will  be
  1494.                 returned to the main Area Manager screen.
  1495.  
  1496.  
  1497.               - Ins: Add
  1498.  
  1499.                 Adds a  new echo  area, and  takes you  into editing  mode.
  1500.                 Added records are automatically  inserted into the list  so
  1501.                 that is it maintained in alphabetical order.
  1502.  
  1503.  
  1504.               - Del: Delete
  1505.  
  1506.                 Deletes the  current  echo  area. You  will  be  asked  for
  1507.                 confirmation.
  1508.  
  1509.  
  1510.               - Home: First
  1511.  
  1512.                 Takes you  to  the first  echo  area (they  are  sorted  in
  1513.                 ascending alphabetical order).
  1514.  
  1515.  
  1516.               - End: Last
  1517.  
  1518.                 Takes you to the last echo area.
  1519.  
  1520.  
  1521.               - ESC: Exit
  1522.  
  1523.                 Leaves the Echo Area Manager, saving any changes made.  F10
  1524.                 will do the same thing.
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.     ┌─────────────────────────────────────────────────────────────────────┐ 
  1536.     └── (C) Fabiano Fabris ───────────────────────────────────────── 18 ──┘
  1537.  
  1538.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐ 
  1539.     └─────────────────────────────────────────────────────────────────────┘
  1540.  
  1541.  
  1542.  
  1543.  
  1544.               - PgUp/PgDn: Previous/Next
  1545.  
  1546.                 The PgUp and PgDn keys move between the echo area  records.
  1547.                 Once you have found  the one you are  looking for, you  may
  1548.                 edit it with F1.
  1549.  
  1550.  
  1551.            2) The Echo Area Record
  1552.  
  1553.               What follows is a description of the individual fields of the
  1554.               echo area record, and how they are used and changed.
  1555.  
  1556.               All fields are required unless stated otherwise.
  1557.  
  1558.  
  1559.               - Area Name
  1560.  
  1561.                 This is the name of  the echo area, sometimes called  "Area
  1562.                 Tag". The name may be up to 20 characters long; it will  be
  1563.                 forced into upper case. Special characters such as '-', '_'
  1564.                 and '.' may be  used, but no spaces  may appear. Please  be
  1565.                 sure of  the spelling  of the  name, since  it is  used  to
  1566.                 identify which board an  incoming message should be  tossed
  1567.                 into.
  1568.  
  1569.                 Note that it is not possible  to define two areas with  the
  1570.                 same area name.  IMSETUP will show  a warning message,  and
  1571.                 you will  be  prompted to  correct  the name.  This  is  to
  1572.                 prevent cross-linked areas.
  1573.  
  1574.  
  1575.               - Active
  1576.  
  1577.                 This by default is  set to 'Y', which  means that the  echo
  1578.                 area is active. If set to 'N', IMAIL will behave as if  the
  1579.                 area had not been defined.
  1580.  
  1581.                 This will allow you to disable an echo area for any  reason
  1582.                 you may wish,  without having  to actually  delete it,  and
  1583.                 later re-enter it.
  1584.  
  1585.  
  1586.               - Comment
  1587.  
  1588.                 Here  you  may  enter  a   brief  (up  to  60   characters)
  1589.                 description of the area. This  description is used by  some
  1590.                 of the export functions (see Section e.), and may also help
  1591.                 remind you what the subject of the echo is.
  1592.  
  1593.                 This field is optional.
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.     ┌─────────────────────────────────────────────────────────────────────┐ 
  1600.     └── (C) Fabiano Fabris ───────────────────────────────────────── 19 ──┘
  1601.  
  1602.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐ 
  1603.     └─────────────────────────────────────────────────────────────────────┘
  1604.  
  1605.  
  1606.  
  1607.  
  1608.               - Origin Line
  1609.  
  1610.                 Here you may specify up to 63 characters which will be used
  1611.                 as the origin line for the  echo area (see Chapter 10.  for
  1612.                 more information on Origin lines).
  1613.  
  1614.                 To this will be prefixed the string
  1615.  
  1616.                     * Origin:
  1617.  
  1618.                 and your origin address (see  below) will be appended.  The
  1619.                 total length must not exceed 79 characters.
  1620.  
  1621.  
  1622.               - Board
  1623.  
  1624.                 In  this  field  you   should  specify  the  board   number
  1625.                 corresponding to the echo area.
  1626.  
  1627.                 The board number may  be between 1  and 200 inclusive  (the
  1628.                 upper limit is imposed by  QuickBBS). The number 0 is  used
  1629.                 by IMAIL to indicate a passthrough area (see below).
  1630.  
  1631.                 IMSETUP will not let you  use the same board number  twice,
  1632.                 because you would be cross-linking echo areas.
  1633.  
  1634.                 TOSS uses this number  when importing echo messages,  since
  1635.                 the  QuickBBS/RemoteAccess   message   bases   contain   no
  1636.                 indication of the area name.  Similarly, SCAN uses this  to
  1637.                 derive the name of an echo area when exporting mail.
  1638.  
  1639.  
  1640.               - Passthrough
  1641.  
  1642.                 If set  to 'Y',  this area  is marked  as passthrough  (and
  1643.                 consequently the board number zeroed).
  1644.  
  1645.                 In other words, echo mail arriving in this area will NOT be
  1646.                 imported into your message base, but only passed on to  any
  1647.                 other systems you might be feeding. If you are not  feeding
  1648.                 any systems, the messages will simply be killed.
  1649.  
  1650.  
  1651.               - Secure
  1652.  
  1653.                 If enabled,  IMAIL will  check the  address of  the  system
  1654.                 which sent the message in this area. If it is listed  among
  1655.                 the systems to whom you are linked, it will be imported and
  1656.                 processed; otherwise,  it  will  be tossed  into  your  Bad
  1657.                 Message Board.
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.     ┌─────────────────────────────────────────────────────────────────────┐ 
  1664.     └── (C) Fabiano Fabris ───────────────────────────────────────── 20 ──┘
  1665.  
  1666.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐ 
  1667.     └─────────────────────────────────────────────────────────────────────┘
  1668.  
  1669.  
  1670.  
  1671.  
  1672.               - # Days
  1673.  
  1674.                 This item  is used  by  IMTHINGS KILL  /U (see  Chapter  9.
  1675.                 Section d.) to  determine which messages  to kill: it  will
  1676.                 mark as deleted any messages older than the number of  days
  1677.                 specified here. If this field is left at zero, no  messages
  1678.                 will  be  killed,  unless  the  "#  Msgs"  field  below  is
  1679.                 specified.
  1680.  
  1681.                 The maximum value  which can  be entered in  this field  is
  1682.                 255.
  1683.  
  1684.                 If the area  is marked  as Passthrough, this  field has  no
  1685.                 meaning.
  1686.  
  1687.  
  1688.               - Group
  1689.  
  1690.                 A letter  between A  and Z  which identifies  the group  to
  1691.                 which this echo belongs.
  1692.  
  1693.                 Groups are  used  primarily  by the  AreaLink  function  to
  1694.                 indicate which nodes may request links to which echo areas.
  1695.  
  1696.                 For more information on this,  see Section e., and  Chapter
  1697.                 7.
  1698.  
  1699.  
  1700.               - Tiny-Seens
  1701.  
  1702.                 Enable this option  is you  want to strip  all the  SEEN-BY
  1703.                 information from  an incoming  echo  message before  it  is
  1704.                 re-exported.
  1705.  
  1706.                 In this case,  the outgoing message  will contain only  the
  1707.                 SEEN-BYs of your downlinks. Note, however, that if the area
  1708.                 is not marked as passthrough, and if the Keep-Seens  option
  1709.                 (below) is active,  the message will  be imported with  the
  1710.                 original SEEN-BY information.
  1711.  
  1712.  
  1713.               - Keep-Seens
  1714.  
  1715.                 Enable this  option  if  you want  to  import  the  SEEN-BY
  1716.                 information  into  your  message  base.  If  disabled,  the
  1717.                 SEEN-BY lines will be stripped from the message.
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.     ┌─────────────────────────────────────────────────────────────────────┐ 
  1728.     └── (C) Fabiano Fabris ───────────────────────────────────────── 21 ──┘
  1729.  
  1730.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐ 
  1731.     └─────────────────────────────────────────────────────────────────────┘
  1732.  
  1733.  
  1734.  
  1735.  
  1736.               - # Msgs
  1737.  
  1738.                 This is used by  IMTHINGS KILL /U  (see Chapter 9.  Section
  1739.                 d.) to determine how many  message to leave in this  board.
  1740.                 If this field is left at  zero, it will be ignored, and  no
  1741.                 messages will be  killed, unless  the "#  Days" field  (see
  1742.                 above) is specified.
  1743.  
  1744.                 Naturally, is the  area is Passthrough,  this field has  no
  1745.                 meaning.
  1746.  
  1747.  
  1748.               - XRS (R)
  1749.  
  1750.                 This field allows you to specify an address as import-only.
  1751.                 In other words, when IMAIL is TOSSing mail, it will  accept
  1752.                 echo messages from the  specified system (even if  security
  1753.                 is enabled), but will never export to it.
  1754.  
  1755.                 This is intended primarily for  use with systems which  use
  1756.                 XRS or an equivalent program,  with which users may  upload
  1757.                 and download their mail, thus becoming "fake points" of the
  1758.                 system.
  1759.  
  1760.  
  1761.               - Origin Address
  1762.  
  1763.                 Pressing F1 while editing an area will allow you to  choose
  1764.                 the address to use in the Origin line of the message.
  1765.  
  1766.                 You will be presented  with a window  containing a list  of
  1767.                 all the addresses defined  in the "System Addresses"  menu;
  1768.                 select one of these.
  1769.  
  1770.                 This address will also be used in the PATH line of the echo
  1771.                 message, as well as in the list of SEEN-BYs.
  1772.  
  1773.                 Note that only the net and  node numbers will be placed  in
  1774.                 the SEEN-BYs  and PATH  lines; the  use of  zone and  point
  1775.                 numbers is not  accepted. However, IMAIL  is able to  parse
  1776.                 zone and point information from these lines, if found.
  1777.  
  1778.  
  1779.               - Seen-Bys
  1780.  
  1781.                 Pressing F2 while editing an area will allow you to  choose
  1782.                 one or more addresses to add  to the SEEN-BY line for  that
  1783.                 area.
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.     ┌─────────────────────────────────────────────────────────────────────┐ 
  1792.     └── (C) Fabiano Fabris ───────────────────────────────────────── 22 ──┘
  1793.  
  1794.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐ 
  1795.     └─────────────────────────────────────────────────────────────────────┘
  1796.  
  1797.  
  1798.  
  1799.  
  1800.                 If you do not select any addresses, then the one  specified
  1801.                 as "Origin Address" will by default be used.
  1802.  
  1803.                 Note, as above,  that zone  and point numbers  will not  be
  1804.                 placed in the SEEN-BY lines generated by IMAIL.
  1805.  
  1806.  
  1807.               - Export List
  1808.  
  1809.                 Pressing F3 will  bring up the  Export List Manager.  Here,
  1810.                 you may specify up to 60 systems to which this echo will be
  1811.                 exported.
  1812.  
  1813.  
  1814.         e. Node Export Manager
  1815.  
  1816.            The Node Export Manager is used to specify information regarding
  1817.            the systems to which you  normally export mail, including  which
  1818.            program will be used to  compress outbound mail for the  system,
  1819.            as well as what type of file attach to generate.
  1820.  
  1821.            The editing keys  are the same  as those used  in the Echo  Area
  1822.            Manager, so for more information, refer to that section.
  1823.  
  1824.  
  1825.            1) Address
  1826.  
  1827.               Here you specify the address of the system. The Zone, Net and
  1828.               node are required. If no point is specified, it will  default
  1829.               to 0.
  1830.  
  1831.  
  1832.            2) Password
  1833.  
  1834.               If specified, this will be the password that the system  will
  1835.               use when requesting areas or  information from Area Link.  If
  1836.               no password  is specified,  the system  may not  request  any
  1837.               areas, even if one or more groups have been enabled.
  1838.  
  1839.               For more information on Area Link, see Chapter 7.
  1840.  
  1841.  
  1842.            3) Groups
  1843.  
  1844.               List the Groups to which the system may have access. Up to 26
  1845.               may be specified.
  1846.  
  1847.               A system must  have a Group  enabled in order  to be able  to
  1848.               request a link to any echo area which is part of that Group.
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.     ┌─────────────────────────────────────────────────────────────────────┐ 
  1856.     └── (C) Fabiano Fabris ───────────────────────────────────────── 23 ──┘
  1857.  
  1858.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐ 
  1859.     └─────────────────────────────────────────────────────────────────────┘
  1860.  
  1861.  
  1862.  
  1863.  
  1864.            4) Direct
  1865.  
  1866.               If this flag is set to  'Y', ARCmail generated for this  node
  1867.               will be  marked DIRECT.  In  other words,  it will  not  (and
  1868.               cannot) be routed. If it is set to 'N', it will not be marked
  1869.               as DIRECT, and thus can be routed via other systems.
  1870.  
  1871.               It is STRONGLY recommended that  echo mail NOT be routed,  so
  1872.               if the node is your echo mail feed, it is best to mark it  as
  1873.               Direct.
  1874.  
  1875.               Note that any systems  not defined in  the Node Manager  will
  1876.               not have their mail marked DIRECT.
  1877.  
  1878.  
  1879.            5) Remote Maint (R)
  1880.  
  1881.               Registered users  of IMAIL  may allow  systems to  carry  out
  1882.               changes in the links for other systems. These changes may  be
  1883.               made via AreaLink, using the %FROM meta-command (see  Chapter
  1884.               7. section b.).
  1885.  
  1886.               In order to  enable a node  to make these  changes for  other
  1887.               systems, this field must be set to 'Y'; the default is 'N'.
  1888.  
  1889.  
  1890.            6) Status
  1891.  
  1892.               Pressing F1 while editing a node's information will allow you
  1893.               to change  the  file  attach  status.  By  default,  this  is
  1894.               "Normal", but you may select one of:
  1895.  
  1896.                  Normal       No status
  1897.                  Hold         Hold message for pick up
  1898.                  Crash        Send message Crash
  1899.  
  1900.  
  1901.            7) Program
  1902.  
  1903.               If you press F2 while editing a node's information, you  will
  1904.               be able to select the program to use for mail compression.  A
  1905.               list will appear, containing the programs you defined in  the
  1906.               "Compression Programs" menu,
  1907.  
  1908.               If you make no selection, by default the first program in the
  1909.               list will be used.
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.     ┌─────────────────────────────────────────────────────────────────────┐ 
  1920.     └── (C) Fabiano Fabris ───────────────────────────────────────── 24 ──┘
  1921.  
  1922.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐ 
  1923.     └─────────────────────────────────────────────────────────────────────┘
  1924.  
  1925.  
  1926.  
  1927.  
  1928.            8) Capability
  1929.  
  1930.               The Capability describes the  other system's mail  processor.
  1931.               Currently, two type are defined:
  1932.  
  1933.                  Stone Age
  1934.                  Type 2+
  1935.  
  1936.               The first type of processor is not able to recognize the zone
  1937.               and point information in  message packet headers. The  second
  1938.               type does, and  makes use  of this information.  IMAIL is  an
  1939.               example of the second type.
  1940.  
  1941.               Set this field  according to the  capability of the  system's
  1942.               mail processor, if known. If you are unsure, leave the  field
  1943.               set to "Stone Age".
  1944.  
  1945.               For more information  on the  capability word,  refer to  the
  1946.               FTSC documents  FSC-0039  and FSC-0048.  See  also  FTS-0001.
  1947.               These documents  may be  available  near you;  otherwise  you
  1948.               should be able to file request them from 1:1/20.
  1949.  
  1950.  
  1951.         f. Pack Routing
  1952.  
  1953.            In this  menu  you may  specify  default routing  for  the  PACK
  1954.            command (see Chapter  6. Section  d.); in other  words, you  may
  1955.            specify that net mail for one or more systems be compressed in a
  1956.            packet addressed to another system, from which (presumably)  the
  1957.            mail will be forwarded on.
  1958.  
  1959.            The menu is composed  of two columns:  "Route Via", and  "Routed
  1960.            Systems".
  1961.  
  1962.            Put simply, net mail for any of the systems given in the  second
  1963.            column will be compressed into a packet addressed to the  system
  1964.            given in the first column.
  1965.  
  1966.            If no systems are listed  in the "Routed Systems" column,  IMAIL
  1967.            will simply  look for  and  compress mail  for the  "Route  Via"
  1968.            address.
  1969.  
  1970.            To edit these entries,  position the cursor  on the desired  row
  1971.            and press <ENTER>. You will then be able to edit the "Route Via"
  1972.            address. Once finished, another <ENTER> will automatically  take
  1973.            you to  the  list of  "Routed  Systems", which  you  may  modify
  1974.            individually.
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.     ┌─────────────────────────────────────────────────────────────────────┐ 
  1984.     └── (C) Fabiano Fabris ───────────────────────────────────────── 25 ──┘
  1985.  
  1986.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐ 
  1987.     └─────────────────────────────────────────────────────────────────────┘
  1988.  
  1989.  
  1990.  
  1991.  
  1992.            IMSETUP supports the use of the "ALL" macro when specifying  the
  1993.            "Routed Systems". This macro  may be used in  place of the  net,
  1994.            node or  point fields  (the zone  should always  be given).  For
  1995.            example:
  1996.  
  1997.               27:All                 All net  mail  messages  addressed  to
  1998.                                      systems in Zone 27
  1999.  
  2000.               27:1331/All            All net mail messages addressed to the
  2001.                                      nodes in Zone 27, Net 1331
  2002.  
  2003.               27:1331/100.All        All net mail messages addressed to the
  2004.                                      points of node 27:1331/100. Note  that
  2005.                                      this is equivalent to:
  2006.  
  2007.               27:1331/100            By default, IMAIL  will pack net  mail
  2008.                                      messages for  a  point  via  its  boss
  2009.                                      node. If  you  wish to  indicate  only
  2010.                                      certain  points,  you  will  have   to
  2011.                                      specify them explicitly:
  2012.  
  2013.               27:1331/100.1          This will pack messages for point 1 of
  2014.                                      the system  27:1331/100 via  the  node
  2015.                                      specified in the "Route Via" column.
  2016.  
  2017.            If you do  not specify the  Zone, IMSETUP will  use the Zone  as
  2018.            defined in your primary address.
  2019.  
  2020.            Note that if you are a "boss" node, net mail to your points will
  2021.            never be pack routed unless  explicitly specified (see the  last
  2022.            example above). So if your address is 2:230/41, and you wish  to
  2023.            pack net mail  for your points  via 2:230/40, you  will need  to
  2024.            have "2:230/41.All" in the list of Routed Systems.
  2025.  
  2026.  
  2027.         g. Import/Export
  2028.  
  2029.            Registered users of  IMAIL have  available to them  a series  of
  2030.            import and export functions. These are listed below.
  2031.  
  2032.  
  2033.            1) Import Areas.Bbs
  2034.  
  2035.               With this function, you may import the information  contained
  2036.               in an AREAS.BBS file. This file must conform to the  standard
  2037.               used  by  QuickBBS/QEcho   systems.  In   other  words,   the
  2038.               recognized format is:
  2039.  
  2040.                  <board number> <area name> <export list>
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.     ┌─────────────────────────────────────────────────────────────────────┐ 
  2048.     └── (C) Fabiano Fabris ───────────────────────────────────────── 26 ──┘
  2049.  
  2050.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐ 
  2051.     └─────────────────────────────────────────────────────────────────────┘
  2052.  
  2053.  
  2054.  
  2055.  
  2056.               The board number should be between 1 and 200.  Alternatively,
  2057.               it may be  the letter 'P',  in which case,  the area will  be
  2058.               marked as Passthrough.
  2059.  
  2060.               The area name is  the name of  the echo area,  and may be  in
  2061.               lower case or  upper case;  it will be  converted into  upper
  2062.               case when imported.
  2063.  
  2064.               The export list is the list  of systems to which you will  be
  2065.               feeding the echo. If no zone is specified, it will default to
  2066.               your primary zone. However, both the zone and net numbers are
  2067.               "sticky", which means that if  specified, they will be  valid
  2068.               until changed. For example:
  2069.  
  2070.                  2:310/11 12 13
  2071.  
  2072.               means that you  will be exporting  to 2:310/11, 2:310/12  and
  2073.               2:310/13. Point  numbers may  also  be specified.  Thus  this
  2074.               function actually recognizes a superset of the QEcho format.
  2075.  
  2076.               Note that the  first line of  the file will  be ignored,  and
  2077.               anything on a line following a semi-colon (';') will also  be
  2078.               discarded. Therefore,  the file  may  contain any  number  of
  2079.               comments.
  2080.  
  2081.               If the board number and/or the area name are already  defined
  2082.               in IMSETUP, you will  be asked if you  wish to overwrite  the
  2083.               area information, or create a  new area. In the second  case,
  2084.               you will be prompted for a new board number.
  2085.  
  2086.               Once the Areas.Bbs  file has  been imported, go  to the  Echo
  2087.               Area Manager and edit the comment field, the Origin line, the
  2088.               Group and the  SEEN-BY addresses, and  any other  information
  2089.               you wish to change.
  2090.  
  2091.               This function  is available  in  unregistered copies  of  the
  2092.               program also.
  2093.  
  2094.  
  2095.            2) Export Areas Config (R)
  2096.  
  2097.               With this  function,  you  may  export part  or  all  of  the
  2098.               information  regarding  the  echo  areas  you  have  defined.
  2099.               Specify the Groups for which you want information exported.
  2100.  
  2101.               A file is created  containing all the information  pertaining
  2102.               to each area, and ordered alphabetically by area. This may be
  2103.               used for your own reference, or to send to other systems.
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.     ┌─────────────────────────────────────────────────────────────────────┐ 
  2112.     └── (C) Fabiano Fabris ───────────────────────────────────────── 27 ──┘
  2113.  
  2114.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐ 
  2115.     └─────────────────────────────────────────────────────────────────────┘
  2116.  
  2117.  
  2118.  
  2119.  
  2120.            3) Create Areas.Bbs File (R)
  2121.  
  2122.               This option  allows you  to create  an Areas.Bbs  type  file,
  2123.               which may then be used by other programs.
  2124.  
  2125.               Note that the first line  of the generated file will  contain
  2126.               information about  your  system, and  the  second will  be  a
  2127.               comment.
  2128.  
  2129.               The format  of  the  generated  file  is  the  same  as  that
  2130.               recognized by the Import  function (see above). However,  the
  2131.               system   number    are   always    given   in    full    form
  2132.               (Zone:Net/Node.Point).
  2133.  
  2134.  
  2135.            4) Export Group List (R)
  2136.  
  2137.               Selecting this  function will  generate a  file containing  a
  2138.               list of all echos ordered by Group.
  2139.  
  2140.               The data consists simply of the area name and comment.
  2141.  
  2142.  
  2143.            5) Export Nodes Config (R)
  2144.  
  2145.               This will create a file containing all the information on the
  2146.               systems defined with the Node Manager.
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.     ┌─────────────────────────────────────────────────────────────────────┐ 
  2176.     └── (C) Fabiano Fabris ───────────────────────────────────────── 28 ──┘
  2177.  
  2178.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  2179.     └─────────────────────────────────────────────────────────────────────┘
  2180.  
  2181.  
  2182.  
  2183.  
  2184.      6. IMAIL COMMAND LINE OPTIONS
  2185.  
  2186.         Once you have configured the program via IMSETUP, you are ready  to
  2187.         use  IMAIL.  There  are   three  separate  commands  or   functions
  2188.         "contained" in IMAIL, and they are invoked via the command line.
  2189.  
  2190.         The syntax used to invoke IMAIL is:
  2191.  
  2192.            IMAIL TOSS | SCAN | PACK | ALNK | /?
  2193.  
  2194.         The switch ? may be prefixed with a dash (-) or a slash (/);  IMAIL
  2195.         will recognize both. If no command  is given, IMAIL will display  a
  2196.         help screen, and return to the DOS prompt.
  2197.  
  2198.         Here is a description of the commands.
  2199.  
  2200.  
  2201.         a. /? - Help
  2202.  
  2203.            This will cause IMAIL to display a brief summary of its  command
  2204.            line options on the screen. Any other commands will be ignored.
  2205.  
  2206.  
  2207.         b. TOSS - Toss Incoming Mail
  2208.  
  2209.            This enables  IMAIL's  TOSS  function.  This  will  search  your
  2210.            inbound files directory for mail and toss it into your  QuickBBS
  2211.            or RemoteAccess message base; net  mail messages will end up  in
  2212.            the net mail subdirectory, while echo mail will be put into  the
  2213.            correct message area.
  2214.  
  2215.            The TOSS function  will automatically forward  any echo mail  to
  2216.            other links,  as well  as net  mail messages,  if you  have  not
  2217.            specified that it is not to  forward net mail. Outgoing mail  is
  2218.            automatically compressed, and a file attach message generated.
  2219.  
  2220.            Unregistered copied of IMAIL  will have a  kludge line added  to
  2221.            all forwarded messages, thus slightly increasing the size of the
  2222.            outgoing packet.
  2223.  
  2224.            Note that IMAIL TOSS  will return an ERRORLEVEL  of 1 if it  has
  2225.            processed  net  mail  messages.  This   fact  can  be  used   to
  2226.            selectively call IMAIL ALNK only if net mail messages have  been
  2227.            received.
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.     ┌─────────────────────────────────────────────────────────────────────┐
  2240.     └── (C) Fabiano Fabris ───────────────────────────────────────── 29 ──┘
  2241.  
  2242.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  2243.     └─────────────────────────────────────────────────────────────────────┘
  2244.  
  2245.  
  2246.  
  2247.  
  2248.            1) /B - Check Bad Message Board
  2249.  
  2250.               Use this switch is you wish to force IMAIL to check  messages
  2251.               in  the   Bad  Message   Board.   This  will   override   the
  2252.               configuration setting (see Chapter 5. section a.).
  2253.  
  2254.               What will happen is this: if an echo message is found,  IMAIL
  2255.               will search to see if it  belongs to an area defined in  your
  2256.               Areas file  (IMAIL.AR);  if the  correct  are is  found,  the
  2257.               message will be moved to the correct board.
  2258.  
  2259.               Please note  that  if you  are  tossing dupes  into  the  Bad
  2260.               Message Board (rather than having a separate board for them),
  2261.               then any  dupes found  will  also be  moved. This  option  is
  2262.               useful in those cases in which your echo feed has "turned on"
  2263.               an area which has not yet been defined in your areas file.
  2264.  
  2265.  
  2266.            2) /N - No AreaLink
  2267.  
  2268.               Normally, after TOSS has processed incoming messages, it will
  2269.               call AreaLink  to process  any  requests. For  those  systems
  2270.               which do not have downlinks, or which prefer to run  AreaLink
  2271.               separately, this may be disabled.
  2272.  
  2273.               Simply run TOSS with  a /N command  line parameter, as  given
  2274.               below:
  2275.  
  2276.                  IMAIL TOSS /N
  2277.  
  2278.               and AreaLink will not be invoked.
  2279.  
  2280.  
  2281.         c. SCAN - Scan for Outgoing Mail
  2282.  
  2283.            This enables the echo/net mail  SCAN function. The QuickBBS  (or
  2284.            RemoteAccess) message base will be searched for outgoing net and
  2285.            echo mail, exporting it to packets.
  2286.  
  2287.            If the messages are  echo mail, a packet  will be generated  for
  2288.            each of  the downlinks  listed for  the area;  for net  mail,  a
  2289.            single packet will be created, destined to the addressee of  the
  2290.            message.
  2291.  
  2292.            If the destination  system is  listed in the  Node Manager,  the
  2293.            appropriate compression program will  be called to compress  the
  2294.            packet; otherwise, the  first program  listed will  be used  (by
  2295.            default, ARC).
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.     ┌─────────────────────────────────────────────────────────────────────┐
  2304.     └── (C) Fabiano Fabris ───────────────────────────────────────── 30 ──┘
  2305.  
  2306.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  2307.     └─────────────────────────────────────────────────────────────────────┘
  2308.  
  2309.  
  2310.  
  2311.  
  2312.            1) /N - No default pack routing
  2313.  
  2314.               By default, IMAIL SCAN will pack route any net mail messages,
  2315.               according to the information given in IMSETUP (see Chapter 5.
  2316.               Section f.).
  2317.  
  2318.               If for any reason you do not wish to pack route the net  mail
  2319.               messages exported  by  SCAN, specify  the  /N switch  on  the
  2320.               command line. Then all  net mail messages  will be packed  to
  2321.               their real destination.
  2322.  
  2323.               Due to space  and time  considerations, IMAIL  SCAN does  not
  2324.               permit the same flexibility of net mail pack routing as  does
  2325.               IMAIL PACK. To achieve this flexibility, EXPORT the net  mail
  2326.               with IMTHINGS (see Chapter 9. Section a.) and then run  IMAIL
  2327.               PACK.
  2328.  
  2329.  
  2330.         d. PACK - Pack Net Mail Messages
  2331.  
  2332.            This calls IMAIL's packer. The IMAIL Net Mail Message  Directory
  2333.            will be searched for outgoing  net mail messages, which will  be
  2334.            compressed  into  ARCmail  compressed  files  according  to  the
  2335.            information given on the command line, and specified in  IMSETUP
  2336.            (see Chapter 5. Section f.).
  2337.  
  2338.            Note that this command operates only on MSG style messages.  Net
  2339.            mail messages in the quickbbsQuickBBS message base will be pack
  2340.            routed by the SCAN command, and default routing will be applied,
  2341.            unless the /N switch is given (see below).
  2342.  
  2343.            The syntax of the PACK command is:
  2344.  
  2345.               PACK [z:n/nd[.p] [[...] VIA z:n/nd[.p]]] [/N] [/C] [/H]
  2346.  
  2347.            (The square  brackets  enclose  optional  elements.)  'z:n/nd.p'
  2348.            represents a network address in the usual form:
  2349.  
  2350.               zone:net/node.point
  2351.  
  2352.            where the point  field is optional.  If not specified,  messages
  2353.            addressed to point of the given system will be packed along with
  2354.            the mail for that system. If you are a "boss" node, net mail for
  2355.            your points will never be  pack routed via another node,  unless
  2356.            explicitly forced with the ".ALL" macro (see below).
  2357.  
  2358.            As with IMSETUP, the net, node and point fields may be  replaced
  2359.            with the  'ALL' macro.  If you  omit the  zone field,  the  zone
  2360.            defined for  your  primary  network  address  will  be  used  by
  2361.            default.
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.     ┌─────────────────────────────────────────────────────────────────────┐
  2368.     └── (C) Fabiano Fabris ───────────────────────────────────────── 31 ──┘
  2369.  
  2370.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  2371.     └─────────────────────────────────────────────────────────────────────┘
  2372.  
  2373.  
  2374.  
  2375.  
  2376.            If more than one system is given on the command line, then there
  2377.            MUST be a 'via' node; that is,  a system for which all the  mail
  2378.            for the preceding systems will  be packed. Therefore, a  command
  2379.            such as:
  2380.  
  2381.               IMAIL PACK 24:ALL 25:ALL 27:27/1
  2382.  
  2383.            is not valid, and IMAIL will complain. Similarly, remember  that
  2384.            if you write
  2385.  
  2386.               IMAIL PACK ALL
  2387.  
  2388.            you are specifying more  than one system,  in which case,  there
  2389.            must be a 'via' node.
  2390.  
  2391.            When run PACK will  scan the command  line for routing  commands
  2392.            and act on them, after which it will process the default routing
  2393.            commands given in IMSETUP, which means that you may override the
  2394.            defaults. If no parameters are given on the command line,  IMAIL
  2395.            will simply act on the defaults.
  2396.  
  2397.            For example, the command:
  2398.  
  2399.               IMAIL PACK 24:ALL 25:ALL VIA 27:27/1
  2400.  
  2401.            will collect any outgoing messages  for all systems in zones  24
  2402.            and 25, as well as messages for 27:27/1, and compress them  into
  2403.            a file attach for 27:27/1.
  2404.  
  2405.            Please note  that by  default  mail for  points will  always  be
  2406.            routed via the boss system. Therefore the commands
  2407.  
  2408.               IMAIL PACK 2:230/41.ALL
  2409.  
  2410.            and
  2411.  
  2412.               IMAIL PACK 2:230/41
  2413.  
  2414.            are equivalent. In both cases  all mail for the system  2:230/41
  2415.            and any of its points will be compressed into the same file.
  2416.  
  2417.            As another example, you may specify:
  2418.  
  2419.               IMAIL PACK ALL VIA 27:27/1
  2420.  
  2421.            If your primary zone is 27, this will pack all outgoing mail for
  2422.            systems in zone 27 via the system 27:27/1.
  2423.  
  2424.            If you are a  "boss" node (that is,  you have points), net  mail
  2425.            for points can only be pack routed explicitly. For example:
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.     ┌─────────────────────────────────────────────────────────────────────┐
  2432.     └── (C) Fabiano Fabris ───────────────────────────────────────── 32 ──┘
  2433.  
  2434.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  2435.     └─────────────────────────────────────────────────────────────────────┘
  2436.  
  2437.  
  2438.  
  2439.  
  2440.               IMAIL PACK 27:1339/103.ALL VIA 27:1339/103.1
  2441.  
  2442.            This applies also  to default  pack routing. Also  note that  it
  2443.            applies only to  4D addressing  (addresses which  use the  point
  2444.            number); fake net addresses will not be checked, so care  should
  2445.            be taken that net  mail destined to a  fakenet address is  never
  2446.            pack routed out of your point net.
  2447.  
  2448.            Messages  which  are  file   attaches,  file  requests,   update
  2449.            requests, or  which have  the IMMediate  or DIRect  status  will
  2450.            NEVER be packed.
  2451.  
  2452.  
  2453.            1) /N - No default pack routing
  2454.  
  2455.               If for any  reason you wish  the PACK command  to ignore  the
  2456.               defaults given  in  IMSETUP,  suffix the  switch  /N  to  the
  2457.               command line. In  this case,  IMAIL will  simply process  the
  2458.               command line.
  2459.  
  2460.               Note that the command
  2461.  
  2462.                  IMAIL PACK /N
  2463.  
  2464.               effectively  tells  IMAIL  to  do  nothing,  since  no  route
  2465.               commands are given  in the  command line, and  the /N  switch
  2466.               tells IMAIL to ignore the defaults.
  2467.  
  2468.  
  2469.            2) /C - Pack Crash Messages
  2470.  
  2471.               If you want IMAIL to pack messages marked with Crash  status,
  2472.               specify the /C switch on the command line.
  2473.  
  2474.               Otherwise, IMAIL will by default NOT pack Crash messages.
  2475.  
  2476.  
  2477.            3) /H - Pack Hold Messages
  2478.  
  2479.               If you  want  to pack  messages  marked as  Hold  along  with
  2480.               "normal" messages, specify the /H switch on the command line.
  2481.  
  2482.               Normally, IMAIL will not pack messages with the Hold bit set.
  2483.  
  2484.  
  2485.            4) /? - Help
  2486.  
  2487.               If you  do not  give IMAIL  PACK any  parameters, or  if  you
  2488.               specify the /? switch, IMAIL will display a brief summary  of
  2489.               its options.
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.     ┌─────────────────────────────────────────────────────────────────────┐
  2496.     └── (C) Fabiano Fabris ───────────────────────────────────────── 33 ──┘
  2497.  
  2498.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  2499.     └─────────────────────────────────────────────────────────────────────┘
  2500.  
  2501.  
  2502.  
  2503.  
  2504.         e. ALNK - AreaLink
  2505.  
  2506.            This parameter calls the IMAIL AreaLink function to scan the net
  2507.            mail message  area for  requests. For  more information  on  how
  2508.            AreaLink works, see Chapter 7.
  2509.  
  2510.            Please note that the AreaLink function is automatically  invoked
  2511.            after every run of the TOSS  command, unless you specify the  /N
  2512.            (No AreaLink) switch.
  2513.  
  2514.  
  2515.         f. Other Information
  2516.  
  2517.  
  2518.            1) Packet Compression
  2519.  
  2520.               In all cases, IMAIL will check the amount of free disk space;
  2521.               if it finds that less that 50Kb remain, it will compress  all
  2522.               packets created before making new ones. This should help ease
  2523.               situations where disk space is at a premium.
  2524.  
  2525.               Otherwise, IMAIL will  normally create  all outgoing  packets
  2526.               before beginning  to compress  them. This  is done  so as  to
  2527.               speed up the program.
  2528.  
  2529.  
  2530.            2) New Echo Areas
  2531.  
  2532.               When TOSS finds echo  mail in areas that  are not defined  in
  2533.               the Area Manager,  it will  toss them into  your Bad  Message
  2534.               board. It  will  also create  a  file called  IMAIL.NE  which
  2535.               contains the name of the area, and the system from which  you
  2536.               received the echo mail. (Registered copies will also generate
  2537.               a message to the Sysop, stating which new areas were received
  2538.               and from whom).
  2539.  
  2540.               The next time you run IMSETUP,  if this file is present,  you
  2541.               will  be  asked   if  you   wish  the  areas   to  be   added
  2542.               automatically. If you reply affirmatively, the areas will  be
  2543.               created, and the sending system  will be added to the  export
  2544.               list. Note that it  will still be necessary  to edit the  new
  2545.               areas to define the board number and group.
  2546.  
  2547.               If you have "Check Bad  Message Board" enabled, the next  run
  2548.               of IMAIL  TOSS  will move  the  echo messages  from  the  Bad
  2549.               Message Board  to the  area defined.  Alternatively, you  may
  2550.               force this by running TOSS with the /B switch (see Chapter 6.
  2551.               section b.).
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.     ┌─────────────────────────────────────────────────────────────────────┐
  2560.     └── (C) Fabiano Fabris ───────────────────────────────────────── 34 ──┘
  2561.  
  2562.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  2563.     └─────────────────────────────────────────────────────────────────────┘
  2564.  
  2565.  
  2566.  
  2567.  
  2568.      7. AREALINK
  2569.  
  2570.         AreaLink is a function which allows other systems to request  echos
  2571.         from your system without the need  for you to manually insert  them
  2572.         in the areas'  export list. It  is similar in  function to  AreaMgr
  2573.         (which is part of TosScan), or to AreaFix.
  2574.  
  2575.         What happens is this: a system  sends a message addressed to  IMAIL
  2576.         on your system. Instead  of the subject, he  places a password.  In
  2577.         the body of  the message will  go the  list of areas  to which  the
  2578.         other system  wishes to  be linked,  or areas  which he  no  longer
  2579.         wishes to receive.  The system  may also  request information  from
  2580.         IMAIL by including one or more of the supported meta-commands.
  2581.  
  2582.         In order to be able  to use AreaLink, a  system must be defined  in
  2583.         your Node Manager (See section e. of Chapter 5.). When the  request
  2584.         is processed by Area Link, it will check that the password given on
  2585.         the subject line of the message matches the one defined in the node
  2586.         manager.
  2587.  
  2588.         Also, AreaLink will only allow a system to request areas  belonging
  2589.         to one of the groups to which he has access.
  2590.  
  2591.  
  2592.         a. Format of the Request
  2593.  
  2594.            As outlined  above,  a  request to  AreaLink  takes  a  specific
  2595.            format. Here is an example:
  2596.  
  2597.               From:    John Doe on 27:4339/0
  2598.               To:      IMAIL on 27:27/0
  2599.               Subject: password
  2600.               ------------------------------------
  2601.               +Z27.SYSOP          <= Request to add area
  2602.               +SIG.OP             <= Request to add area
  2603.               -SIG.PENPAL         <= Request to remove area
  2604.               %query              <= Request for active areas
  2605.               %list               <= Request for available areas
  2606.               %rescan             <= Request to rescan new areas
  2607.  
  2608.            All names, the  password, area  names and  meta-commands may  be
  2609.            given in any combination of upper and lower case.
  2610.  
  2611.            As can be seen, in order to  request that an area be added,  the
  2612.            name of  the area  must  be prefixed  with  a plus  ('+')  sign,
  2613.            whereas to have a area removed, it must be prefixed with a minus
  2614.            ('-') sign.
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.     ┌─────────────────────────────────────────────────────────────────────┐
  2624.     └── (C) Fabiano Fabris ───────────────────────────────────────── 35 ──┘
  2625.  
  2626.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  2627.     └─────────────────────────────────────────────────────────────────────┘
  2628.  
  2629.  
  2630.  
  2631.  
  2632.            The first character on a  line MUST be one  of '+', '-' or  '%'.
  2633.            (The last of these three characters denotes a meta-command;  see
  2634.            section b. below.)
  2635.  
  2636.            Note that requests may be addressed to:
  2637.               IMAIL
  2638.               AREALINK
  2639.               AREAFIX
  2640.               AREAMGR
  2641.            AreaLink will recognize any of the above "names".
  2642.  
  2643.            Optionally, the message may end in a tear line ('---'), followed
  2644.            by any text (usually a message to the sysop). In this case,  the
  2645.            request will not  be deleted.  If the message  contains no  tear
  2646.            line, it will be removed once processed.
  2647.  
  2648.            Besides this, the message may contain meta-commands.
  2649.  
  2650.  
  2651.         b. Meta-Commands
  2652.  
  2653.            IMAIL supports several meta-commands in AreaLink requests. These
  2654.            are:
  2655.  
  2656.  
  2657.            1) %ALL
  2658.  
  2659.               The %ALL meta-command may be used to link or unlink all areas
  2660.               available to the requesting system. It is used in one of  two
  2661.               ways:
  2662.  
  2663.                  +%ALL   Links all available areas
  2664.                  -%ALL   Unlinks all linked areas
  2665.  
  2666.               This meta-command  may be  combined  with the  "normal"  link
  2667.               requests to form a  request for all areas  except one or  two
  2668.               specific ones (or vice versa). For example:
  2669.  
  2670.                  +%ALL
  2671.                  -SIG.JUNK
  2672.  
  2673.               will link all areas available except for the SIG.JUNK echo.
  2674.  
  2675.               Note that if %RESCAN (see below) is given in the same message
  2676.               as a +%ALL, all the newly linked echos will be rescaned.
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.     ┌─────────────────────────────────────────────────────────────────────┐
  2688.     └── (C) Fabiano Fabris ───────────────────────────────────────── 36 ──┘
  2689.  
  2690.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  2691.     └─────────────────────────────────────────────────────────────────────┘
  2692.  
  2693.  
  2694.  
  2695.  
  2696.            2) %FROM (R)
  2697.  
  2698.               On registered copies  of IMAIL, the  %FROM meta-command  will
  2699.               allow another  system  to  make requests  "on  behalf"  of  a
  2700.               different system.  This  is particularly  useful  for  remote
  2701.               maintenance of someone  else's system. In  order to do  this,
  2702.               the system  must  be  enabled via  IMSETUP  (see  Chapter  5.
  2703.               section e.).
  2704.  
  2705.               The format of the meta-command is
  2706.  
  2707.                  %FROM <full node number>
  2708.  
  2709.               where the address must include  the zone and point fields  of
  2710.               the system which will be linked (or unlinked).
  2711.  
  2712.               Note that  the  password (subject)  of  the message  must  be
  2713.               correct for  the  system SENDING  the  message, not  for  the
  2714.               system for  which the  changes will  be made.  The  generated
  2715.               reply will  be send,  again,  to the  system which  sent  the
  2716.               request, not to the one for which the changes were made.
  2717.  
  2718.  
  2719.            3) %LIST
  2720.  
  2721.               The %LIST meta-command will have  AreaLink reply with a  list
  2722.               of all the areas available to the requesting system. In other
  2723.               words, those which are marked as Active, and which belong  to
  2724.               a group listed as available for that system.
  2725.  
  2726.  
  2727.            4) %QUERY
  2728.  
  2729.               If the  message  contains this  meta-command,  AreaLink  will
  2730.               reply  with  a  list  of  currently  active  echos  for   the
  2731.               requesting system
  2732.  
  2733.  
  2734.            5) %RESCAN
  2735.  
  2736.               This meta-command will  allow a  node to  request that  IMAIL
  2737.               send all old mail in the  areas requested. For example, if  a
  2738.               system requests to be linked to the SYSOP echo, and places  a
  2739.               %RESCAN meta-command in the message text, IMAIL will link the
  2740.               system, and then scan your  message base for any messages  in
  2741.               this area, and send them to the requesting system.
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.     ┌─────────────────────────────────────────────────────────────────────┐
  2752.     └── (C) Fabiano Fabris ───────────────────────────────────────── 37 ──┘
  2753.  
  2754.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  2755.     └─────────────────────────────────────────────────────────────────────┘
  2756.  
  2757.  
  2758.  
  2759.  
  2760.               All the exported messages will have the same SEEN-BY lines as
  2761.               they normally would, thus (hopefully) preventing  duplicates.
  2762.               However, the messages  will be  exported only  to the  system
  2763.               requesting the rescan, not to all linked nodes.
  2764.  
  2765.               Note that if you have set the Allow Rescan option in  IMSETUP
  2766.               to "no" (see Chapter 5. Section 4)), then the rescan  request
  2767.               will be ignored.
  2768.  
  2769.  
  2770.         c. AreaLink Replies
  2771.  
  2772.            When it has processed a request, AreaLink will generate a  reply
  2773.            message to the system  who sent the  request. This message  will
  2774.            contain the list  of echo  areas added and/or  removed for  that
  2775.            system, as well as query and list information, if indicated.
  2776.  
  2777.            The message will be marked as  Kill/Sent (ie it will be  deleted
  2778.            once sent) unless you  have configured IMAIL  to keep them  (see
  2779.            Chapter 5. Section 4)).
  2780.  
  2781.  
  2782.         d. Forward Link Requests (R)
  2783.  
  2784.            Registered users  of IMAIL  may define  one or  more systems  as
  2785.            uplinks, specifying the name of a file containing a list of echo
  2786.            areas available on those systems.
  2787.  
  2788.            If a system  requests an  echo area not  currently available  on
  2789.            your system, AreaLink  will search the  files specified for  the
  2790.            required echo. If it is found, it will generate a request to the
  2791.            given uplink. At  the same time,  it will create  a file  called
  2792.            IMAIL.NE which will be  read the next time  you run IMSETUP.  If
  2793.            IMSETUP finds this file, it will ask you if you wish to add  the
  2794.            new area to your configuration.  IMAIL.NE is the same file  used
  2795.            to store information  regarding new echos  that have arrived  at
  2796.            your system (see Chapter 6. section b.).
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.     ┌─────────────────────────────────────────────────────────────────────┐
  2816.     └── (C) Fabiano Fabris ───────────────────────────────────────── 38 ──┘
  2817.  
  2818.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  2819.     └─────────────────────────────────────────────────────────────────────┘
  2820.  
  2821.  
  2822.  
  2823.  
  2824.      8. AUTOMATIC MESSAGE REPLIES (R)
  2825.  
  2826.         If enabled via IMSETUP (see chapter 5., Section a., para 5)), IMAIL
  2827.         will generate  automatic replies  for messages  that have  remained
  2828.         unread for more than the specified number of days.
  2829.  
  2830.         Generally, IMAIL  will  submit  a  standard  message.  However,  if
  2831.         specified, it  can use  a special  text file  when it  generates  a
  2832.         message. This text  file may  contain one  or more  macros, of  the
  2833.         form:
  2834.  
  2835.            %macro%
  2836.  
  2837.         They are explained below. For a sample text, see the file  included
  2838.         in the  distribution  archive.  Please  note that  if  a  macro  is
  2839.         enclosed in  double  quotes, it  will  NOT be  parsed,  but  simple
  2840.         repeated as it is.
  2841.  
  2842.  
  2843.         a. %of%
  2844.  
  2845.            Your first name, as defined in IMSETUP.
  2846.  
  2847.  
  2848.         b. %ol%
  2849.  
  2850.            Your last name, as defined in IMSETUP.
  2851.  
  2852.  
  2853.         c. %os%
  2854.  
  2855.            Your primary system address.
  2856.  
  2857.  
  2858.         d. %df%
  2859.  
  2860.            Destination user's first name.
  2861.  
  2862.  
  2863.         e. %dl%
  2864.  
  2865.            Destination user's last name.
  2866.  
  2867.  
  2868.         f. %ds%
  2869.  
  2870.            Destination user's system address.
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.     ┌─────────────────────────────────────────────────────────────────────┐
  2880.     └── (C) Fabiano Fabris ───────────────────────────────────────── 39 ──┘
  2881.  
  2882.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  2883.     └─────────────────────────────────────────────────────────────────────┘
  2884.  
  2885.  
  2886.  
  2887.  
  2888.         g. %mt%
  2889.  
  2890.            Time of the message for which the reply is being generated.
  2891.  
  2892.  
  2893.         h. %md%
  2894.  
  2895.            Date of the message for which the reply is being generated.
  2896.  
  2897.  
  2898.         i. %at%
  2899.  
  2900.            Current time.
  2901.  
  2902.  
  2903.         j. %ad%
  2904.  
  2905.            Current date.
  2906.  
  2907.  
  2908.         k. %dy%
  2909.  
  2910.            Number of days for which the message has been "sitting" unread.
  2911.  
  2912.  
  2913.         l. %im%
  2914.  
  2915.            IMAIL signature.
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.     ┌─────────────────────────────────────────────────────────────────────┐
  2944.     └── (C) Fabiano Fabris ───────────────────────────────────────── 40 ──┘
  2945.  
  2946.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  2947.     └─────────────────────────────────────────────────────────────────────┘
  2948.  
  2949.  
  2950.  
  2951.  
  2952.      9. IMTHINGS
  2953.  
  2954.         IMTHINGS is a program containing additional utilities for use  with
  2955.         IMAIL. It is used  giving it a  command and additional  parameters,
  2956.         which vary according to the command given.
  2957.  
  2958.         For example:
  2959.  
  2960.            IMTHINGS KILL /B2
  2961.  
  2962.         will mark as deleted all messages in board 2.
  2963.  
  2964.         For more  information,  see  the  descriptions  of  the  individual
  2965.         commands below.
  2966.  
  2967.         In most  cases, the  commands  may be  abbreviated  to one  or  two
  2968.         letters; for example
  2969.  
  2970.            IMTHINGS KILL
  2971.  
  2972.         may be given as
  2973.  
  2974.            IMTHINGS K
  2975.  
  2976.         However,
  2977.  
  2978.            IMTHINGS STAT
  2979.  
  2980.         must be abbreviated to
  2981.  
  2982.            IMTHINGS ST
  2983.  
  2984.         since the SEND command also begin with the letter 'S'.
  2985.  
  2986.  
  2987.         a. EXPORT - Export Net Mail Messages
  2988.  
  2989.            This function  allows net  mail messages  to be  moved from  the
  2990.            QuickBBS net  mail  board to  the  net mail  directory,  in  MSG
  2991.            format. This is particularly useful with regard to net mail pack
  2992.            routing (see Chapter 6. Section d.).
  2993.  
  2994.            The function takes no parameters. It will scan the message base,
  2995.            looking for  net  mail  messages  that  are  destined  to  other
  2996.            systems, and are  marked as Local.  Messages which have  already
  2997.            been sent will be ignored.
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.     ┌─────────────────────────────────────────────────────────────────────┐
  3008.     └── (C) Fabiano Fabris ───────────────────────────────────────── 41 ──┘
  3009.  
  3010.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3011.     └─────────────────────────────────────────────────────────────────────┘
  3012.  
  3013.  
  3014.  
  3015.  
  3016.            Any messages which are exported from the net mail board will  be
  3017.            marked  there  as   Sent,  and  if   required,  as  Deleted.   A
  3018.            corresponding  MSG  file  will  be  created  in  the  net   mail
  3019.            directory.
  3020.  
  3021.  
  3022.         b. IMPORT - Import Net Mail Messages
  3023.  
  3024.            The IMPORT function allows you to import net mail messages  from
  3025.            the net mail directory into  the QuickBBS message base. This  is
  3026.            necessary is you wish to allow the users of your BBS to read net
  3027.            mail addressed to them.
  3028.  
  3029.            This command  has  no parameters.  It  will scan  the  net  mail
  3030.            directory for net mail messages  addressed to one of your  AKAs,
  3031.            and if  found,  import  them  into  the  net  mail  board.  Once
  3032.            imported, the MSG file will be deleted.
  3033.  
  3034.            NOTE: net mail messages which  are also File Requests or  Update
  3035.            Requests will  not be  imported. However,  File Attach  messages
  3036.            will. So to avoid problems, it is best to run IMAIL TOSS  before
  3037.            IMTHINGS IMPORT.
  3038.  
  3039.            The  INDEX  command  is  run  automatically  after  IMPORT   has
  3040.            terminated.
  3041.  
  3042.  
  3043.         c. INDEX - Rebuild index files
  3044.  
  3045.            The INDEX  command will  rebuild the  message base  index  files
  3046.            (MSGIDX.BBS, MSGTOIDX.BBS and  MSGINFO.BBS) from the  MSGHDR.BBS
  3047.            file. Use this if for any reason you suspect that one or more of
  3048.            these files have somehow become damaged.
  3049.  
  3050.            Note  that  INDEX  is  run  automatically  after  the  following
  3051.            functions:
  3052.  
  3053.               IMPORT
  3054.               MOVE
  3055.               SORT
  3056.  
  3057.            The INDEX function has no command line parameters.
  3058.  
  3059.  
  3060.         d. KILL - Delete messages from an area
  3061.  
  3062.            The KILL  command allows  you to  mark as  deleted some  or  all
  3063.            messages in a specified  message area. Note  that KILL does  NOT
  3064.            pack the message base. Use IMTHINGS PACK for this.
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.     ┌─────────────────────────────────────────────────────────────────────┐
  3072.     └── (C) Fabiano Fabris ───────────────────────────────────────── 42 ──┘
  3073.  
  3074.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3075.     └─────────────────────────────────────────────────────────────────────┘
  3076.  
  3077.  
  3078.  
  3079.  
  3080.            The syntax of the command is:
  3081.  
  3082.               IMTHINGS KILL /A<areaname>
  3083.                             /B<board>
  3084.                             /D<days>
  3085.                             /N<number>
  3086.                             /O
  3087.                             /P
  3088.                             /U
  3089.  
  3090.  
  3091.            1) /A<areaname>
  3092.  
  3093.               If specified, the /A switch should be followed by the name of
  3094.               one of the echo areas, as given in the Area Manager. If  this
  3095.               switch is used, then the /B switch should NOT be given.
  3096.  
  3097.               NOTE: If  you specify  the  /U switch,  this switch  will  be
  3098.               ignored.
  3099.  
  3100.  
  3101.            2) /B<board>
  3102.  
  3103.               If specified, the /B switch  should be followed by a  message
  3104.               board number. In this way, it is possible to "act" on message
  3105.               board not defined in the  IMSETUP Area Manager (for  example,
  3106.               local message areas). If the /B  switch is used, then the  /A
  3107.               switch should NOT be given.
  3108.  
  3109.               If you do not specify one of /A or /B, then KILL will act  on
  3110.               ALL message  boards,  unless  the /U  switch  is  given  (see
  3111.               below).
  3112.  
  3113.  
  3114.            3) /D<days>
  3115.  
  3116.               This allows you  to specify  that KILL  should keep  messages
  3117.               younger than the given number of  days. If the switch is  not
  3118.               used, then IMTHINGS will not check the date of the message.
  3119.  
  3120.               Note that if the  /U switch is given,  the /D switch will  be
  3121.               ignored.
  3122.  
  3123.  
  3124.            4) /N<number>
  3125.  
  3126.               If this switch is used, KILL will leave the specified  number
  3127.               of messages in the base, marking the rest as deleted.
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.     ┌─────────────────────────────────────────────────────────────────────┐
  3136.     └── (C) Fabiano Fabris ───────────────────────────────────────── 43 ──┘
  3137.  
  3138.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3139.     └─────────────────────────────────────────────────────────────────────┘
  3140.  
  3141.  
  3142.  
  3143.  
  3144.               Note that if neither /N nor /D are specified, then KILL  will
  3145.               mark ALL messages in the designated board as deleted,  unless
  3146.               the /U switch is  given (see below). If  both are given,  the
  3147.               KILL will ensure that both criteria are met, in which case it
  3148.               may leave less than <number> messages in the area if it finds
  3149.               "old" messages.
  3150.  
  3151.  
  3152.            5) /O - PACK with Overwrite
  3153.  
  3154.               If the /O  switch is given  with the /P  switch (see  below),
  3155.               PACK will be run in  overwrite mode. For more information  on
  3156.               the PACK command, see Section h.
  3157.  
  3158.               Note that the /O switch has  effect only if used with the  /P
  3159.               switch; it will be ignored otherwise.
  3160.  
  3161.  
  3162.            6) /P - Run PACK after KILL
  3163.  
  3164.               If you specify the /P parameter, KILL will automatically  run
  3165.               PACK if any messages were marked as deleted. This can be used
  3166.               with the /U parameter, or with any of the others.
  3167.  
  3168.               In order to PACK the message base in overwrite mode,  specify
  3169.               also the /O switch (see above).
  3170.  
  3171.               Note that once the message base is PACKed, no messages can be
  3172.               recovered.
  3173.  
  3174.  
  3175.            7) /U - Use Default Information
  3176.  
  3177.               This parameter  tells IMTHINGS  KILL to  use the  information
  3178.               given in IMSETUP to determine  how many messages to kill.  It
  3179.               will operate  on all  boards defined  in the  Areas  Manager,
  3180.               leaving the  given  numbers  of messages  in  the  board,  or
  3181.               deleting all messages older than the given number of days.
  3182.  
  3183.               PLEASE NOTE: if you use the /U switch, the /A, /B, /D and  /N
  3184.               switches will be ignored if also specified.
  3185.  
  3186.  
  3187.         e. LINK - Link Messages in Message Base
  3188.  
  3189.            In order  to update  the links  between the  messages and  their
  3190.            replies, run IMTHINGS LINK after  each arrival of echo mail,  or
  3191.            at least once a night.
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.     ┌─────────────────────────────────────────────────────────────────────┐
  3200.     └── (C) Fabiano Fabris ───────────────────────────────────────── 44 ──┘
  3201.  
  3202.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3203.     └─────────────────────────────────────────────────────────────────────┘
  3204.  
  3205.  
  3206.  
  3207.  
  3208.            LINK scans the  message base,  looks for  messages with  similar
  3209.            subject lines, and  from them, creates  links for each  message,
  3210.            which point to the previous message  in the chain, and the  next
  3211.            message.
  3212.  
  3213.            Note that  the case  of the  subject line  is significant;  thus
  3214.            "Echo mail" and "Echo Mail" will not match when creating  links.
  3215.            However, any leading "re:" will  be stripped before a search  is
  3216.            performed.
  3217.  
  3218.            There are no command line  parameters; link will operate on  the
  3219.            entire message base.
  3220.  
  3221.  
  3222.         f. MOVE - Move Message Area
  3223.  
  3224.            The MOVE command allows  you to move all  the messages from  one
  3225.            board (or area) to another. The syntax of the command allows you
  3226.            to specify  the source  and destination  areas either  by  board
  3227.            number or by area name (if it exists).
  3228.  
  3229.               IMTHINGS MOVE /SA<src area> | /SB<src board>
  3230.                             /DA<dst area> | /DB<dst board>
  3231.  
  3232.            Please note that all messages moved will be marked as LOCAL,  so
  3233.            that they  will  not  be  SCANned out  again  by  mistake,  thus
  3234.            creating confusion in the network.
  3235.  
  3236.            The  INDEX  function  is   run  automatically  after  MOVE   has
  3237.            terminated.
  3238.  
  3239.  
  3240.            1) /SA<src area>
  3241.  
  3242.               If you  know the  area name  as specified  in IMSETUP's  Area
  3243.               Manager, you may  use this  switch. If you  use this  switch,
  3244.               then do NOT use the /SB switch.
  3245.  
  3246.               For example:
  3247.  
  3248.                  IMTHINGS MOVE /SASYSOP /DB12
  3249.  
  3250.               will move all messages from the SYSOP are to board 12  (which
  3251.               might be a local board).
  3252.  
  3253.  
  3254.  
  3255.  
  3256.  
  3257.  
  3258.  
  3259.  
  3260.  
  3261.  
  3262.  
  3263.     ┌─────────────────────────────────────────────────────────────────────┐
  3264.     └── (C) Fabiano Fabris ───────────────────────────────────────── 45 ──┘
  3265.  
  3266.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3267.     └─────────────────────────────────────────────────────────────────────┘
  3268.  
  3269.  
  3270.  
  3271.  
  3272.            2) /SB<src board>
  3273.  
  3274.               If the source board is local,  it will have no area name;  so
  3275.               specify the board  number using  the /SB switch.  If you  use
  3276.               /SB, then do NOT use /SA.
  3277.  
  3278.  
  3279.            3) /DA<dst area>
  3280.  
  3281.               You may specify the destination  area name with this  switch.
  3282.               It is used in the same way as /SA. If you use the /DA switch,
  3283.               then do NOT use /DB.
  3284.  
  3285.  
  3286.            4) /DB<dst board>
  3287.  
  3288.               If the destination board is local, it will not be defined  in
  3289.               the Area Manager; so  you may specify  the board number.  See
  3290.               above for an example of its use. If you use this switch, then
  3291.               do NOT use /DA.
  3292.  
  3293.  
  3294.         g. NOTIFY - Send list of linked echos
  3295.  
  3296.            The NOTIFY function  will send  a list  of the  echos for  which
  3297.            systems are linked  to your node.  It will generate  a net  mail
  3298.            message to each system which is linked to at least one echo area
  3299.            on your node, requesting that the list be checked for accuracy.
  3300.  
  3301.  
  3302.         h. PACK - Compress message base
  3303.  
  3304.            When you delete a message, it  is not actually removed from  the
  3305.            base, but rather  is just marked  in a special  way (thus it  is
  3306.            possible to "undelete"  them - see  the RECOVER command  below).
  3307.            PACK will  allow  you to  remove  from the  message  base  those
  3308.            messages marked as deleted, thus recovering unused disk space.
  3309.  
  3310.            Optionally, it is also  possible to have  PACK renumber all  net
  3311.            mail messages.
  3312.  
  3313.            The syntax of the command is:
  3314.  
  3315.               IMTHINGS PACK /B
  3316.                             /C
  3317.                             /O
  3318.                             /R
  3319.  
  3320.  
  3321.  
  3322.  
  3323.  
  3324.  
  3325.  
  3326.  
  3327.     ┌─────────────────────────────────────────────────────────────────────┐
  3328.     └── (C) Fabiano Fabris ───────────────────────────────────────── 46 ──┘
  3329.  
  3330.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3331.     └─────────────────────────────────────────────────────────────────────┘
  3332.  
  3333.  
  3334.  
  3335.  
  3336.            PACK will also search for, and delete, any cross-linked messages
  3337.            it finds in the message base, if the /C switch is specified (see
  3338.            below).
  3339.  
  3340.            PACK will update the USERS.BBS file (if it is found) as well  as
  3341.            LASTREAD.BBS (this file keeps track of the last messages read in
  3342.            each message area).
  3343.  
  3344.  
  3345.            1) /B - Keep backup
  3346.  
  3347.               If you specify this switch, PACK will not delete the  backups
  3348.               it made of the five files which comprise the message base.
  3349.  
  3350.  
  3351.            2) /C - Check for cross-linked message
  3352.  
  3353.               If this switch is specified,  PACK will check for and  delete
  3354.               any messages which  are cross-linked (in  other words,  which
  3355.               have the same message number, or share the same space in  the
  3356.               MSGTXT.BBS file).  Note that  this will  degrade  performance
  3357.               significantly.
  3358.  
  3359.  
  3360.            3) /O - Overwrite
  3361.  
  3362.               Use this switch if you have limited disk space (less than the
  3363.               size of the MSG*.BBS files); it will force PACK to  overwrite
  3364.               the message base  while compressing it.  Use great care  when
  3365.               specifying this  switch,  since  a power  loss  could  easily
  3366.               destroy the entire message base.
  3367.  
  3368.  
  3369.            4) /R - Renumber
  3370.  
  3371.               Giving the /B  switch will  have PACK renumber  all net  mail
  3372.               messages.
  3373.  
  3374.  
  3375.         i. POST - Post message in echo area
  3376.  
  3377.            The POST function will  allow you to post  a message in an  echo
  3378.            area.  It  is  particularly  useful  for  posting  echo  message
  3379.            statistics, for example.
  3380.  
  3381.            The syntax of the command is:
  3382.  
  3383.  
  3384.  
  3385.  
  3386.  
  3387.  
  3388.  
  3389.  
  3390.  
  3391.     ┌─────────────────────────────────────────────────────────────────────┐
  3392.     └── (C) Fabiano Fabris ───────────────────────────────────────── 47 ──┘
  3393.  
  3394.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3395.     └─────────────────────────────────────────────────────────────────────┘
  3396.  
  3397.  
  3398.  
  3399.  
  3400.               IMTHINGS POST /F<filename>
  3401.                             /A<areaname>
  3402.                             /B<board>
  3403.                             /W<to_who>
  3404.                             /S<subject>
  3405.  
  3406.  
  3407.            1) /F<filename>
  3408.  
  3409.               The /F switch is used to specify the name of the text file to
  3410.               post as the message. This file should be a simple ASCII file,
  3411.               containing no special control  characters. This parameter  is
  3412.               required.
  3413.  
  3414.  
  3415.            2) /A<areaname>
  3416.  
  3417.               To specify the  name of the  echo area in  which to post  the
  3418.               message, use the /A switch. The name of the area may be given
  3419.               in upper or lower case, or any combination of the two. If you
  3420.               use this switch, do NOT use the /B switch.
  3421.  
  3422.  
  3423.            3) /B<board>
  3424.  
  3425.               Use the /B switch to give the number of the message board  in
  3426.               which to post the  message. If you use  this switch, then  do
  3427.               NOT use the /A switch.
  3428.  
  3429.  
  3430.            4) /W<to_who>
  3431.  
  3432.               You may optionally specify the name of the person to whom the
  3433.               message is  addressed.  If  this parameter  is  omitted,  the
  3434.               message will be addressed to 'All'.
  3435.  
  3436.               If the  /W parameter  is  used, the  name should  contain  no
  3437.               spaces; replace the spaces with underscores: /WFabiano_Fabris
  3438.  
  3439.  
  3440.            5) /S<subject>
  3441.  
  3442.               You may also specify the subject  of the message with the  /S
  3443.               switch. If  this parameter  is omitted,  the message  subject
  3444.               will be 'News'.
  3445.  
  3446.               If you do use this  parameter, the text following the  switch
  3447.               should contain no spaces; replace them with underscores.  For
  3448.               example: /STest_message_#1
  3449.  
  3450.  
  3451.  
  3452.  
  3453.  
  3454.  
  3455.     ┌─────────────────────────────────────────────────────────────────────┐
  3456.     └── (C) Fabiano Fabris ───────────────────────────────────────── 48 ──┘
  3457.  
  3458.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3459.     └─────────────────────────────────────────────────────────────────────┘
  3460.  
  3461.  
  3462.  
  3463.  
  3464.         j. RECOVER (R) - Unerase messages
  3465.  
  3466.            The RECOVER command  will allow  you to  "undelete" messages  in
  3467.            your message base. Naturally, it will only work if you have  not
  3468.            PACKed the base.
  3469.  
  3470.            By default,  RECOVER  will  "undelete"  messages  found  in  any
  3471.            message area, prompting  you at each  message. However, you  may
  3472.            specify that it look for messages  in a specific area, and  that
  3473.            it automatically recover all deleted messages it finds.
  3474.  
  3475.            The syntax of the command is:
  3476.  
  3477.               IMTHINGS RECOVER /A<areaname>
  3478.                                /B<board>
  3479.                                /U
  3480.  
  3481.  
  3482.            1) /A<areaname>
  3483.  
  3484.               If specified, the /A  switch indicates the  name of the  echo
  3485.               area to search for  deleted messages. If  given, then the  /B
  3486.               switch (see below) should NOT be given.
  3487.  
  3488.  
  3489.            2) /B<board>
  3490.  
  3491.               If specified, this switch indicates  the board to search  for
  3492.               deleted messages.  Giving the  board number  allows you  more
  3493.               flexibility, since  local message  areas are  not defined  as
  3494.               echo areas, and therefore have no name - the /A switch cannot
  3495.               be used. If you  use this switch, the  /A switch (see  above)
  3496.               should NOT be given.
  3497.  
  3498.  
  3499.            3) /U - Automatic Mode
  3500.  
  3501.               Automatic mode. If  this switch  is given,  RECOVER will  not
  3502.               prompt you at each message.  Instead, it will "undelete"  all
  3503.               messages it finds (if /A  or /B are specified, only  messages
  3504.               in the specified message area will be recovered).
  3505.  
  3506.  
  3507.         k. SEND (R) - Send a file
  3508.  
  3509.            The SEND command invokes the IMAIL Robot. This will allow you to
  3510.            send a  file  to  another  system, much  like  any  other  Robot
  3511.            program.
  3512.  
  3513.            This command is available only in registered copies of IMAIL.
  3514.  
  3515.  
  3516.  
  3517.  
  3518.  
  3519.     ┌─────────────────────────────────────────────────────────────────────┐
  3520.     └── (C) Fabiano Fabris ───────────────────────────────────────── 49 ──┘
  3521.  
  3522.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3523.     └─────────────────────────────────────────────────────────────────────┘
  3524.  
  3525.  
  3526.  
  3527.  
  3528.            The syntax of the SEND command is:
  3529.  
  3530.               IMTHINGS SEND /F<filename>
  3531.                             /A<address>
  3532.                             /W<to_who>
  3533.                             /T<text>
  3534.                             /C | /H
  3535.                             /D
  3536.                             /K
  3537.                             /E
  3538.                             /Y<days>
  3539.                             /1-10
  3540.  
  3541.            If the parameters are given correctly, and the required file  is
  3542.            found, a file attach message will be generated in your Net  Mail
  3543.            directory. The parameters are explained below.
  3544.  
  3545.            This command is available to registered users only.
  3546.  
  3547.  
  3548.            1) /F<filename>
  3549.  
  3550.               Indicates the  full pathname  of the  file to  be sent.  This
  3551.               parameter is required.
  3552.  
  3553.               If the filename contains  wildcards, only the first  matching
  3554.               file will be sent.
  3555.  
  3556.  
  3557.            2) /A<address>
  3558.  
  3559.               Specifies the destination address of the file. This parameter
  3560.               is required.
  3561.  
  3562.               The address should  contain the zone,  otherwise the zone  of
  3563.               your primary address will be used by default.
  3564.  
  3565.  
  3566.            3) /W<to_who>
  3567.  
  3568.               You may optionally specify the name of the person to whom the
  3569.               file is being sent. If this parameter is omitted, the message
  3570.               will be addressed to 'Sysop'.
  3571.  
  3572.               If the  /W parameter  is  used, the  name should  contain  no
  3573.               spaces; replace the spaces with underscores: /WFabiano_Fabris
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.  
  3580.  
  3581.  
  3582.  
  3583.     ┌─────────────────────────────────────────────────────────────────────┐
  3584.     └── (C) Fabiano Fabris ───────────────────────────────────────── 50 ──┘
  3585.  
  3586.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3587.     └─────────────────────────────────────────────────────────────────────┘
  3588.  
  3589.  
  3590.  
  3591.  
  3592.            4) /T<text>
  3593.  
  3594.               This optional switch allows you to specify the name of a text
  3595.               file to be used as the "body" of the file attach message.  If
  3596.               omitted, the message will have no text.
  3597.  
  3598.  
  3599.            5) /C - Crash
  3600.  
  3601.               Mark message with Crash status.
  3602.  
  3603.               This option is mutually exclusive with the Hold option below.
  3604.  
  3605.  
  3606.            6) /H - Hold
  3607.  
  3608.               Mark message with Hold status.
  3609.  
  3610.               This option  is  mutually  exclusive with  the  Crash  option
  3611.               above.
  3612.  
  3613.  
  3614.            7) /D - Direct
  3615.  
  3616.               Send message  Direct. This  means that  in no  case will  the
  3617.               message be routed via another system. It may be used together
  3618.               with the /C or the /H option.
  3619.  
  3620.               Use this  flag only  if your  mailer supports  the FLAGS  DIR
  3621.               kludge.
  3622.  
  3623.  
  3624.            8) /K - Kill/Sent
  3625.  
  3626.               Marks the message  as Kill/Sent. In  other words, once  sent,
  3627.               the message will be automatically deleted from your Net  Mail
  3628.               directory. Otherwise, it will remain, but be marked as Sent.
  3629.  
  3630.  
  3631.            9) /E - Delete/Sent
  3632.  
  3633.               Marks the message as Delete/Sent. This will cause the  mailer
  3634.               to delete the file once it has been sent.
  3635.  
  3636.               Use this  flag only  if your  mailer supports  the FLAGS  KFS
  3637.               kludge.
  3638.  
  3639.  
  3640.  
  3641.  
  3642.  
  3643.  
  3644.  
  3645.  
  3646.  
  3647.     ┌─────────────────────────────────────────────────────────────────────┐
  3648.     └── (C) Fabiano Fabris ───────────────────────────────────────── 51 ──┘
  3649.  
  3650.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3651.     └─────────────────────────────────────────────────────────────────────┘
  3652.  
  3653.  
  3654.  
  3655.  
  3656.            10) /Y<days> - Newer than
  3657.  
  3658.               Indicates that the file must be  newer than <days> for it  to
  3659.               be sent.
  3660.  
  3661.               This is useful for  sending nodelist files,  as you can  then
  3662.               specify a wildcard  in the  filename, and  indicate that  the
  3663.               file be sent only if it is newer than, say, 6 days.
  3664.  
  3665.  
  3666.            11) /1-10 - Alternate AKA
  3667.  
  3668.               Tells IMAIL to use one of  your AKAs instead of your  primary
  3669.               address when  generating  the  outgoing  message,  where  the
  3670.               number indicates the AKA as listed in IMSETUP.
  3671.  
  3672.  
  3673.         l. SORT - Sort the Message Base
  3674.  
  3675.            The SORT function will  sort the message  base by message  date.
  3676.            What it  does is  to read  in the  MSGHDR.BBS file,  saving  the
  3677.            message number and time stamp. The list thus created is  sorted,
  3678.            and then the MSGHDR.BBS file  is rewritten, following the  order
  3679.            of the new message numbers.
  3680.  
  3681.            Note that the  SORT command  destroys the message  links, so  it
  3682.            automatically runs INDEX and LINK once it has terminated.
  3683.  
  3684.  
  3685.         m. STAT - Generate Statistics Report
  3686.  
  3687.            The STAT function allows  you to generate a  report of the  echo
  3688.            mail traffic on your system.
  3689.  
  3690.            During each run of IMAIL's TOSS and SCAN functions, IMAIL  keeps
  3691.            track of how  many messages were  imported and/or exported.  The
  3692.            STAT function  of  IMTHINGS  will generate  a  summary  of  this
  3693.            information to the  file specified  in IMSETUP  (Echo Stats  Log
  3694.            File).
  3695.  
  3696.            The syntax of the STAT command is:
  3697.  
  3698.               IMTHINGS STAT /K
  3699.  
  3700.  
  3701.            1) /K - Keep Statistics Information
  3702.  
  3703.               After every run of IMTHINGS STAT, the internal counters  will
  3704.               be zeroed, so each  run will generate statistics  accumulated
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  
  3710.  
  3711.     ┌─────────────────────────────────────────────────────────────────────┐
  3712.     └── (C) Fabiano Fabris ───────────────────────────────────────── 52 ──┘
  3713.  
  3714.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3715.     └─────────────────────────────────────────────────────────────────────┘
  3716.  
  3717.  
  3718.  
  3719.  
  3720.               since  the  previous  run.  This  unless  the  /K  switch  is
  3721.               specified, in which case, the  internal counters will not  be
  3722.               modified, and running totals can be generated.
  3723.  
  3724.  
  3725.  
  3726.  
  3727.  
  3728.  
  3729.  
  3730.  
  3731.  
  3732.  
  3733.  
  3734.  
  3735.  
  3736.  
  3737.  
  3738.  
  3739.  
  3740.  
  3741.  
  3742.  
  3743.  
  3744.  
  3745.  
  3746.  
  3747.  
  3748.  
  3749.  
  3750.  
  3751.  
  3752.  
  3753.  
  3754.  
  3755.  
  3756.  
  3757.  
  3758.  
  3759.  
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.  
  3770.  
  3771.  
  3772.  
  3773.  
  3774.  
  3775.     ┌─────────────────────────────────────────────────────────────────────┐
  3776.     └── (C) Fabiano Fabris ───────────────────────────────────────── 53 ──┘
  3777.  
  3778.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3779.     └─────────────────────────────────────────────────────────────────────┘
  3780.  
  3781.  
  3782.  
  3783.  
  3784.      10. AN OVERVIEW OF ECHOMAIL
  3785.  
  3786.         Information derived from FTS-0004.
  3787.  
  3788.  
  3789.         a. What is Echo Mail?
  3790.  
  3791.            Echo Mail  is  a technique  which  permits several  nodes  in  a
  3792.            network to share messages. All systems sharing a given echo  see
  3793.            any messages entered into the  echo by any of the  participating
  3794.            systems. This can be implemented in such a way as to be  totally
  3795.            transparent to the users of  a particular system. In fact,  they
  3796.            may not even be  aware of the network  being used to move  their
  3797.            messages about from  node to  node! This  has its  disadvantages
  3798.            also - most users  who are not educated  about Echo Mail do  not
  3799.            realize the  messages transmitted  cost MANY  sysops money,  not
  3800.            just the local sysop. This is an important consideration in Echo
  3801.            Mail and  should not  be  taken lightly.  In  an echo  with  100
  3802.            systems as participants the cost per message can get quite high.
  3803.  
  3804.  
  3805.         b. How it Works
  3806.  
  3807.            In general, the process is:
  3808.  
  3809.               1. A message in entered into  a designated area on a  FidoNet
  3810.               or compatible system.
  3811.  
  3812.               2.  This  message  is  "exported"  along  with  some  control
  3813.               information to each system "linked"  to the echo through  the
  3814.               originating system.
  3815.  
  3816.               3. Each of  the receiving systems  "import" the message  into
  3817.               the proper Echo Mail area.
  3818.  
  3819.               4. The receiving systems then "export" these messages,  along
  3820.               with additional control information, to each of their links.
  3821.  
  3822.               5. Return to step 3.
  3823.  
  3824.            The method is quite  simple - in  general. Of course,  following
  3825.            the steps literally would mean  messages would never stop  being
  3826.            exported and transmitted to other systems. This obviously is not
  3827.            desired as the  network would quickly  become overburdened.  The
  3828.            information contained in  the 'control  information' section  is
  3829.            used to prevent transmitting the same message more than once  to
  3830.            a single system.
  3831.  
  3832.  
  3833.  
  3834.  
  3835.  
  3836.  
  3837.  
  3838.  
  3839.     ┌─────────────────────────────────────────────────────────────────────┐
  3840.     └── (C) Fabiano Fabris ───────────────────────────────────────── 54 ──┘
  3841.  
  3842.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3843.     └─────────────────────────────────────────────────────────────────────┘
  3844.  
  3845.  
  3846.  
  3847.  
  3848.         c. Echo Mail Message Control Information
  3849.  
  3850.            There are five pieces of control information associated with  an
  3851.            Echo Mail message.  Some are  optional, some  are not.  Normally
  3852.            this information is  never entered  by the  person creating  the
  3853.            message, but rather is added by the program which is responsible
  3854.            for the exporting of the original message. The following control
  3855.            fields determine how Echo Mail is handled:
  3856.  
  3857.  
  3858.            1) Area Line
  3859.  
  3860.               This is the first  line of an echo  mail message. Its  actual
  3861.               appearance is:
  3862.  
  3863.                  AREA:CONFERENCE
  3864.  
  3865.               where CONFERENCE is the name of the echo. This line is  added
  3866.               when a conference is being  "exported" to another system.  It
  3867.               is based upon information found in the configuration file for
  3868.               the designated message area (in the case of IMAIL, this  file
  3869.               is IMAIL.AR). This field is REQUIRED by the receiving  system
  3870.               to "import" a message into the correct Echo Mail area.
  3871.  
  3872.               Note that  IMAIL will  not handle  echo mail  messages  which
  3873.               "kludge" this field by putting a ^A character in front of it;
  3874.               these messages will be tossed into your net mail directory.
  3875.  
  3876.               Note also that you  may not have two  areas defined with  the
  3877.               same area  name;  this would  create  cross-linked  messages,
  3878.               which are a potential source of duplicates.
  3879.  
  3880.  
  3881.            2) Tear Line
  3882.  
  3883.               This line is near the end of a message and consists of  three
  3884.               dashes (---) followed by an optional program specifier.  This
  3885.               is used  to show  the first  program used  to add  Echo  Mail
  3886.               compatible control information to the message. The tear  line
  3887.               generated by IMAIL looks like:
  3888.  
  3889.                   --- <a small product-specific banner>
  3890.  
  3891.               This  field  is  optional  for  most  Echo  Mail   compatible
  3892.               processors. Some systems will place this line in the  message
  3893.               when it is first created, but  it is normally added when  the
  3894.               message is first "exported."
  3895.  
  3896.  
  3897.  
  3898.  
  3899.  
  3900.  
  3901.  
  3902.  
  3903.     ┌─────────────────────────────────────────────────────────────────────┐
  3904.     └── (C) Fabiano Fabris ───────────────────────────────────────── 55 ──┘
  3905.  
  3906.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3907.     └─────────────────────────────────────────────────────────────────────┘
  3908.  
  3909.  
  3910.  
  3911.  
  3912.            3) Origin Line
  3913.  
  3914.               This line appears near  the bottom of a  message and gives  a
  3915.               small  amount  of  information  about  the  system  where  it
  3916.               originated. It looks like:
  3917.  
  3918.                   * Origin: The Home of IMAIL (27:1339/103)
  3919.  
  3920.               The " * Origin: " part of the line is a constant field.  This
  3921.               is followed by a banner which should in some way identify the
  3922.               system which  originated the  message. The  complete  network
  3923.               address (27:1339/103 in  this case) is  added by the  program
  3924.               inserting the line. This field is generated at the same  time
  3925.               as the tear line,  and therefore may  either be generated  at
  3926.               the time of creation or during the first "export" processing.
  3927.  
  3928.  
  3929.            4) SEEN-BY Lines
  3930.  
  3931.               There can  be many  SEEN-BY lines  at the  end of  Echo  Mail
  3932.               messages, and  they  are  the  real  "meat"  of  the  control
  3933.               information. They  are  used  to  determine  the  systems  to
  3934.               receive the exported messages. The format of the line is:
  3935.  
  3936.                  SEEN-BY: 132/101 113 136/601 1014/1
  3937.  
  3938.               The net/node numbers  correspond to the  net/node numbers  of
  3939.               the systems having already received (or "seen") the  message.
  3940.               In this way a message is never sent to a system twice. In  an
  3941.               Echo with many participants the  number of SEEN-BY lines  can
  3942.               be very large. This line is added if it is not already a part
  3943.               of the message, or added to if it already exists, each time a
  3944.               message is  exported to  other systems.  This is  a  REQUIRED
  3945.               field, and IMAIL will not function correctly if this field is
  3946.               not put in place by other Echo Mail compatible programs.
  3947.  
  3948.  
  3949.            5) PATH Lines
  3950.  
  3951.               These are the last lines in an Echo Mail message. They appear
  3952.               as follows:
  3953.  
  3954.                  ^APATH: 132/101 1014/1
  3955.  
  3956.               where the ^A stands for Control-A (ASCII character 1) and the
  3957.               net/nodes listed correspond to those systems having processed
  3958.               the message before it reached the current system. This is not
  3959.               the same as the SEEN-BY  lines, because those lines list  all
  3960.               systems the message  has been  sent to, while  the path  line
  3961.               contains all systems having actually processed the message.
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.     ┌─────────────────────────────────────────────────────────────────────┐
  3968.     └── (C) Fabiano Fabris ───────────────────────────────────────── 56 ──┘
  3969.  
  3970.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  3971.     └─────────────────────────────────────────────────────────────────────┘
  3972.  
  3973.  
  3974.  
  3975.  
  3976.         d. Methods of Sending Echo Mail
  3977.  
  3978.            To this point the  issue of how Echo  Mail is actually sent  has
  3979.            been glossed over entirely. The phrase has been, "the message is
  3980.            exported to another system." What exactly does this mean?
  3981.  
  3982.            Thom Henderson (from System Enhancement Associates) came up with
  3983.            the original ARCmail program. Having previously written the  ARC
  3984.            file archiving  and compression  program,  he knew  the  savings
  3985.            achievable by having all of the Net Mail messages placed in .ARC
  3986.            format for transmission. As a by-product, the messages no longer
  3987.            appeared in  the net  mail area,  but were  included in  a  file
  3988.            attached to  a message.  In this  way the  tremendous number  of
  3989.            messages generated,  and  the  phone  bill  problems  were  both
  3990.            solved.
  3991.  
  3992.            IMAIL builds the ARCmail files  during export, and unpacks  them
  3993.            during import.  This  way  messages  are  exported  directly  to
  3994.            ARCmail style file attaches, and imported directly from  ARCmail
  3995.            style file attaches.
  3996.  
  3997.  
  3998.         e. Topology
  3999.  
  4000.            The way in which systems link together for a particular Echo  is
  4001.            called the  "echo  topology."  It  is  important  to  know  this
  4002.            structure for two reasons:
  4003.            1) It is important to have a topology which is efficient in  the
  4004.            transfer of the Echo Mail messages;
  4005.            2) It  is important  to have  a topology  which will  not  cause
  4006.            systems to see the same messages more than once.
  4007.  
  4008.            Efficiency can  be measured  in  a number  of ways;  least  time
  4009.            involved for all systems  to receive a  message, least cost  for
  4010.            all systems  to  receive  a  message,  and  fewest  phone  calls
  4011.            required for  all systems  to receive  a message  are all  valid
  4012.            indicators of efficiency. Users of Echo Mail compatible  systems
  4013.            have determined (through  trial and error)  the best measure  of
  4014.            efficiency is a  combination of  all three  of the  measurements
  4015.            given above. Balancing  the equation  is not  trivial, but  some
  4016.            guidelines can be given:
  4017.  
  4018.               1. Never have  two systems  attempting to send  Echo Mail  to
  4019.               each other at  the same  time. This  results in  "collisions"
  4020.               that will  cause both  systems to  fail. To  avoid this,  one
  4021.               system should  be responsible  for  polling while  the  other
  4022.               system is holding mail. This arrangement can alternate  based
  4023.               upon various  criteria,  but  both systems  should  never  be
  4024.               attempting to call each other at the same time.
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.  
  4031.     ┌─────────────────────────────────────────────────────────────────────┐
  4032.     └── (C) Fabiano Fabris ───────────────────────────────────────── 57 ──┘
  4033.  
  4034.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4035.     └─────────────────────────────────────────────────────────────────────┘
  4036.  
  4037.  
  4038.  
  4039.  
  4040.               2. Have nodes  form "stars"  for distribution  of Echo  Mail.
  4041.               This arrangement has several  nodes all receiving their  Echo
  4042.               Mail from  the same  system. In  general the  systems on  the
  4043.               "outside" of the star  poll the system  on the "inside".  The
  4044.               system on the "inside" in turn polls other systems to receive
  4045.               the Echo  Mail  that is  being  passed on  to  the  "outside"
  4046.               systems.
  4047.  
  4048.               3. Utilize  fully connected  polygons  with a  few  vertices.
  4049.               Nodes can be connected in a triangle  (A sends to B and C,  B
  4050.               sends to A and C,  C sends to A and  B) or a fully  connected
  4051.               square (all corners of  the square send to  all of the  other
  4052.               corners).  This  method  is  useful  for  getting  Echo  Mail
  4053.               messages to each node as quickly as possible.
  4054.  
  4055.            All of these efficiency guidelines have to be tempered with  the
  4056.            guidelines dealing with  keeping duplicate  messages from  being
  4057.            exported. Duplicates will  occur in  any topology  that forms  a
  4058.            closed polygon that is not fully connected. Take for example the
  4059.            following configuration:
  4060.  
  4061.                                      A ----- B
  4062.                                      |       |
  4063.                                      |       |
  4064.                                      C ----- D
  4065.  
  4066.            This square is a closed polygon that is not fully connected.  It
  4067.            is capable of generating duplicates as follows:
  4068.  
  4069.               1. A message is entered on node A.
  4070.  
  4071.               2. Node A exports  the message to node  B and node C  placing
  4072.               the SEEN-BY for A, B, and C in the message as it does so.
  4073.  
  4074.               3. Node B sees that node D  is not listed in the SEEN-BY  and
  4075.               exports the message to node D.
  4076.  
  4077.               4. Node C sees that node D  is not listed in the SEEN-BY  and
  4078.               exports the message to node D.
  4079.  
  4080.            At this point  node D has  received the same  message twice -  a
  4081.            duplicate was generated. Normally a  "dupe-ring" will not be  as
  4082.            simple as a square. Generally it  will be caused by a system  on
  4083.            one end of a long chain  accidentally connecting to a system  on
  4084.            the other end  of the  chain. This causes  the two  ends of  the
  4085.            chain to become connected, forming a polygon.
  4086.  
  4087.  
  4088.  
  4089.  
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.     ┌─────────────────────────────────────────────────────────────────────┐
  4096.     └── (C) Fabiano Fabris ───────────────────────────────────────── 58 ──┘
  4097.  
  4098.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4099.     └─────────────────────────────────────────────────────────────────────┘
  4100.  
  4101.  
  4102.  
  4103.  
  4104.         f. Why a PATH line?
  4105.  
  4106.            The PATH line stores the net/node numbers of each system  having
  4107.            actually processed  a message.  This  information is  useful  in
  4108.            correcting the biggest problem  encountered by nodes running  an
  4109.            Echo Mail compatible system -  the problem of finding the  cause
  4110.            of duplicate messages. How  does the PATH  line help solve  this
  4111.            problem? Take the following path line as an example:
  4112.  
  4113.               ^aPATH: 107/6 107/312 107/528 107/312 132/101
  4114.  
  4115.            This shows the message having been processed by node 107/312  on
  4116.            more than one  occasion. Based upon  the earlier description  of
  4117.            the 'information  control' fields  in Echo  Mail messages,  this
  4118.            clearly is an error in processing (see Section b. entitled  "How
  4119.            it Works"). This further  shows node 107/528  as the node  which
  4120.            apparently processed the message  incorrectly. In this case  the
  4121.            path line can be used to quickly locate the source of  duplicate
  4122.            messages.
  4123.  
  4124.            In an Echo with many  participants it becomes almost  impossible
  4125.            to determine the exact topology used. In these cases the use  of
  4126.            the path  line can  help a  coordinator of  the Echo  track  any
  4127.            possible  breakdowns  in   the  overall   topology,  while   not
  4128.            substantially increasing the amount of information  transmitted.
  4129.            Having this small amount of information added to the end of each
  4130.            message pays for itself very quickly when it can be used to help
  4131.            detect a  topology  problem  causing duplicate  messages  to  be
  4132.            transmitted to each system.
  4133.  
  4134.  
  4135.         g. Gating of Echo Mail
  4136.  
  4137.            Until recently, the only network  which made use of the  methods
  4138.            described  above  was  FidoNet.   However,  new  networks   have
  4139.            appeared, and the  problem of  sharing Echo  Mail between  these
  4140.            networks arose.  (To  avoid  ambiguity, the  term  "domain"  was
  4141.            introduced to distinguish between  networks such as FidoNet  and
  4142.            SIGnet.)
  4143.  
  4144.            Sharing (or gating)  of Echo Mail  presents technical  problems.
  4145.            Put simply, the network addresses which are valid in one  domain
  4146.            may not appear in the messages of another domain.
  4147.  
  4148.            The reason for  this is that,  if we consider  only the net  and
  4149.            node fields of a network  address (many mail processors are  not
  4150.            able to  handle the  zone and  point fields),  there is  a  high
  4151.            possibility that a given address exists in another domain.
  4152.  
  4153.  
  4154.  
  4155.  
  4156.  
  4157.  
  4158.  
  4159.     ┌─────────────────────────────────────────────────────────────────────┐
  4160.     └── (C) Fabiano Fabris ───────────────────────────────────────── 59 ──┘
  4161.  
  4162.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4163.     └─────────────────────────────────────────────────────────────────────┘
  4164.  
  4165.  
  4166.  
  4167.  
  4168.            With net  mail, this  problem  may be  solved by  enforcing  the
  4169.            requirement that  inter-domain  mail  be sent  directly  to  its
  4170.            destination, or at least, to a gateway system.
  4171.  
  4172.            With Echo  Mail,  the  problem  is  more  complex,  due  to  the
  4173.            information  contained  in  the  SEEN-BY  and  PATH  lines   (as
  4174.            described above). These lines contain network addresses, and are
  4175.            needed to prevent duplicate rings.
  4176.  
  4177.            However, a strategy has evolved which will allow Echo Mail to be
  4178.            gated.
  4179.  
  4180.            Above all, only ONE system should  be allowed to gate Echo  Mail
  4181.            between domains. This may be  done on a world-wide or  Zone-wide
  4182.            basis. This system  will be responsible  for receiving the  mail
  4183.            from one domain, and feeding it into the other.
  4184.  
  4185.            This is not enough. Due to the possibility of duplicate  network
  4186.            addresses, all SEEN-BYs and PATH lines should be removed  during
  4187.            the gating process. This explains why only one system should  be
  4188.            allowed to gate Echo Mail.
  4189.  
  4190.  
  4191.  
  4192.  
  4193.  
  4194.  
  4195.  
  4196.  
  4197.  
  4198.  
  4199.  
  4200.  
  4201.  
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207.  
  4208.  
  4209.  
  4210.  
  4211.  
  4212.  
  4213.  
  4214.  
  4215.  
  4216.  
  4217.  
  4218.  
  4219.  
  4220.  
  4221.  
  4222.  
  4223.     ┌─────────────────────────────────────────────────────────────────────┐
  4224.     └── (C) Fabiano Fabris ───────────────────────────────────────── 60 ──┘
  4225.  
  4226.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4227.     └─────────────────────────────────────────────────────────────────────┘
  4228.  
  4229.  
  4230.  
  4231.  
  4232.      11. KLUDGE LINES USED BY IMAIL
  4233.  
  4234.         For the more  technically minded, there  follows an explanation  of
  4235.         the various kludge lines that IMAIL may place in messages.
  4236.  
  4237.         A kludge line  is generally defined  as any line  preceded by a  ^A
  4238.         (Control-A) character, and may be  found either before the  message
  4239.         text itself, or after it.
  4240.  
  4241.  
  4242.         a. INTL
  4243.  
  4244.            The INTL kludge is used in net mail messages only. It  indicates
  4245.            that the message is destined to  a zone which is different  from
  4246.            the one in which it originated.
  4247.  
  4248.            The format of the INTL kludge is:
  4249.  
  4250.               ^AINTL <dest zone:net/node> <orig zone:net/node>
  4251.  
  4252.            IMAIL will use this kludge  to try to determine zone  addresses,
  4253.            as well as  adding it to  net mail messages  it generates.  Note
  4254.            that in multi-domain environments  (ie, systems which belong  to
  4255.            more than one domain, and thus  more than one zone), IMAIL  will
  4256.            put an INTL kludge in ALL  net mail messages it generates,  even
  4257.            if the destination and origin zones are the same.
  4258.  
  4259.  
  4260.         b. TOPT
  4261.  
  4262.            To TOPT kludge is used in net mail messages only. It is used  to
  4263.            indicate that the message is directed to a point system,  rather
  4264.            than a "normal" node.
  4265.  
  4266.            The format of this kludge is:
  4267.  
  4268.               ^ATOPT <dest point>
  4269.  
  4270.            where <dest point> is  the point component  of the address.  For
  4271.            example, a message addressed to 2:310/11.22 will have:
  4272.  
  4273.               ^ATOPT 22
  4274.  
  4275.            while the message header will contain the address 310/11.
  4276.  
  4277.            Please note that IMAIL  supports the "extended" message  header,
  4278.            which contains  not only  the  net and  node addresses  (as  per
  4279.            standard), but also the zone and point field. However, since not
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.     ┌─────────────────────────────────────────────────────────────────────┐
  4288.     └── (C) Fabiano Fabris ───────────────────────────────────────── 61 ──┘
  4289.  
  4290.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4291.     └─────────────────────────────────────────────────────────────────────┘
  4292.  
  4293.  
  4294.  
  4295.  
  4296.            all software  support  this header  format,  the TOPT  and  FMPT
  4297.            (below) kludges  are added  whenever  necessary, and  used  when
  4298.            examining inbound messages.
  4299.  
  4300.  
  4301.         c. FMPT
  4302.  
  4303.            The FMPT kludge is used in net mail messages only. It is similar
  4304.            to the TOPT kludge, except that it is used to indicate that  the
  4305.            message originate from a point system.
  4306.  
  4307.            The format of this kludge is:
  4308.  
  4309.               ^AFMPT <orig point>
  4310.  
  4311.            where <orig point> is the point component of the address of  the
  4312.            system originating the message.
  4313.  
  4314.  
  4315.         d. EID
  4316.  
  4317.            The EID is used only in  Echo Mail messages. IMAIL does NOT  add
  4318.            this kludge  to  echo messages.  It  was 'invented'  mostly  for
  4319.            reasons of dupe checking, but  IMAIL will use other methods  for
  4320.            this purpose.
  4321.  
  4322.            The format of the kludge varies; according to the  specification
  4323.            proposed by Jim Nutt, it may be:
  4324.  
  4325.               ^AEID zddd nnnccccc
  4326.  
  4327.            where z is the zone modulo 16,  ddd is the net modulo 4096,  nnn
  4328.            is the net modulo  4096, and ccccc is  a message serial  number.
  4329.            The serial number is generated using  the low order word of  the
  4330.            Unix time  stamp shifted  left  4 bits,  with a  nybble  counter
  4331.            appended.
  4332.  
  4333.  
  4334.         e. MSGID
  4335.  
  4336.            A MSGID kludge is used in all messages, be they net mail of echo
  4337.            mail messages. They  are automatically  added by  IMAIL when  it
  4338.            generates messages (Automatic Reply, Nofoward warning, etc), and
  4339.            used in duplicate checking.
  4340.  
  4341.            The format of  the MSGID follows  the specification proposed  by
  4342.            Jim Nutt, which is:
  4343.  
  4344.               ^AMSGID: zone:net/node[.point]@domain xxxxxxxx
  4345.  
  4346.  
  4347.  
  4348.  
  4349.  
  4350.  
  4351.     ┌─────────────────────────────────────────────────────────────────────┐
  4352.     └── (C) Fabiano Fabris ───────────────────────────────────────── 62 ──┘
  4353.  
  4354.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4355.     └─────────────────────────────────────────────────────────────────────┘
  4356.  
  4357.  
  4358.  
  4359.  
  4360.            where  zone,  net,  node  and  point  are  the  address  of  the
  4361.            origination system, and domain is the domain of the  originating
  4362.            system (eg. FidoNet, SIGnet, etc).  xxxxxxxx is a serial  number
  4363.            which is derived from the  originating system's address, a  Unix
  4364.            time stamp, and an internal counter.
  4365.  
  4366.            IMAIL will automatically supply the  domain by deriving it  from
  4367.            the zone number. If the zone number is not recognized, no domain
  4368.            field will be added.
  4369.  
  4370.  
  4371.         f. REPLY
  4372.  
  4373.            The REPLY kludge is simply a copy of the MSGID of the message to
  4374.            which you are replying. IMAIL does not generate this, except  in
  4375.            the case of  an Automatic  Reply, but it  will use  it in  reply
  4376.            linking.
  4377.  
  4378.            The format is as for MSGIDs:
  4379.  
  4380.               ^AREPLY: zone:net/node[.point]@domain xxxxxxxx
  4381.  
  4382.  
  4383.         g. PID
  4384.  
  4385.            The PID (Product  ID) is appended  by IMAIL to  all messages  it
  4386.            generates.  Following  the   specifications  given  by   Joaquim
  4387.            Homrighausen, the format of the kludge is:
  4388.  
  4389.               ^APID: <product> <major version> [<serial number>]
  4390.  
  4391.            For example, IMAIL 1.2 would generate the kludge as follows:
  4392.  
  4393.               ^APID: IMAIL 1
  4394.  
  4395.  
  4396.         h. FLAGS
  4397.  
  4398.            This kludge is present in net mail messages only, and is used by
  4399.            many mailers to give more information on how the message  should
  4400.            be treated. It is followed by one of more modifiers; some of the
  4401.            more common ones are listed below.
  4402.  
  4403.  
  4404.            1) DIR
  4405.  
  4406.               Indicates that the net mail message should be sent direct  to
  4407.               its destination; it will NEVER be routed.
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.     ┌─────────────────────────────────────────────────────────────────────┐
  4416.     └── (C) Fabiano Fabris ───────────────────────────────────────── 63 ──┘
  4417.  
  4418.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4419.     └─────────────────────────────────────────────────────────────────────┘
  4420.  
  4421.  
  4422.  
  4423.  
  4424.               IMAIL allows you  to specify  whether mail  should be  marked
  4425.               DIRECT or  not.  See  the description  of  the  Node  Manager
  4426.               (Chapter 5. Section e.)
  4427.  
  4428.  
  4429.            2) IMM
  4430.  
  4431.               Indicates that a  message should be  sent immediately.  IMAIL
  4432.               will never use this, and will always ignore it.
  4433.  
  4434.  
  4435.            3) TFS
  4436.  
  4437.               Truncate File when Sent.  This is found  only in file  attach
  4438.               messages, and  indicates that  the file  should be  truncated
  4439.               when sent. ARCmail file attached generates by IMAIL will have
  4440.               this flag set.
  4441.  
  4442.  
  4443.            4) KFS
  4444.  
  4445.               Kill File  when  Sent. This  is  found only  in  file  attach
  4446.               messages, and means that the mailer will delete the file once
  4447.               sent.
  4448.  
  4449.               Please note that  ARCmail file attaches  should NOT use  this
  4450.               flag. If the  ARCmail file  is deleted, the  next time  IMAIL
  4451.               generates an outbound compressed  file for a system,  chances
  4452.               are that it will have the same name as the last one sent  (if
  4453.               the file is generated  on the same day,  at least). If it  is
  4454.               then sent out  to the  system, and  that system  has not  yet
  4455.               processed the mail it had  previously received, there is  the
  4456.               possibility that the  file will be  refused, overwritten,  or
  4457.               discarded.
  4458.  
  4459.  
  4460.            5) CFM
  4461.  
  4462.               Confirmation Receipt Request. This flag is set if the sending
  4463.               system wishes to have an acknowledgement that the message was
  4464.               read. As such, IMAIL does not  intercept this flag; it is  up
  4465.               to the message editor to handle it.
  4466.  
  4467.  
  4468.            6) RRQ
  4469.  
  4470.               Return Receipt  Request.  This flag  is  set if  the  sending
  4471.               system wishes to have an acknowledgement that the message was
  4472.               received by your system.
  4473.  
  4474.  
  4475.  
  4476.  
  4477.  
  4478.  
  4479.     ┌─────────────────────────────────────────────────────────────────────┐
  4480.     └── (C) Fabiano Fabris ───────────────────────────────────────── 64 ──┘
  4481.  
  4482.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4483.     └─────────────────────────────────────────────────────────────────────┘
  4484.  
  4485.  
  4486.  
  4487.  
  4488.               Currently, IMAIL  does not  recognize  this flag,  since  the
  4489.               message header itself defines  a similar bit.  If the bit  is
  4490.               set,  a  registered  version  of  IMAIL  will   automatically
  4491.               generate a reply to the sending system.
  4492.  
  4493.  
  4494.  
  4495.  
  4496.  
  4497.  
  4498.  
  4499.  
  4500.  
  4501.  
  4502.  
  4503.  
  4504.  
  4505.  
  4506.  
  4507.  
  4508.  
  4509.  
  4510.  
  4511.  
  4512.  
  4513.  
  4514.  
  4515.  
  4516.  
  4517.  
  4518.  
  4519.  
  4520.  
  4521.  
  4522.  
  4523.  
  4524.  
  4525.  
  4526.  
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.  
  4534.  
  4535.  
  4536.  
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543.     ┌─────────────────────────────────────────────────────────────────────┐
  4544.     └── (C) Fabiano Fabris ───────────────────────────────────────── 65 ──┘
  4545.  
  4546.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4547.     └─────────────────────────────────────────────────────────────────────┘
  4548.  
  4549.  
  4550.  
  4551.  
  4552.      12. BATCH FILE EXAMPLE
  4553.  
  4554.         The example given below is  designed for systems running  QuickBBS,
  4555.         with FrontDoor as a mailer. It  should be easy to modify for  other
  4556.         setups, but I can only write from my own experience.
  4557.  
  4558.         Please note that  IMAIL is written  specifically for mailers  which
  4559.         make use of the  file attach concept  of mail transfer.  Therefore,
  4560.         mailers such as Binkley will not work correctly with IMAIL. I  made
  4561.         this choice because the method  adopted by Binkley is NOT  standard
  4562.         (please refer to the  FTS and/or FSC series  of documents for  more
  4563.         information), and I currently have no intention of supporting it.
  4564.  
  4565.         ECHO Off
  4566.         :START
  4567.           CD C:\QBBS
  4568.           FD
  4569.           IF ERRORLEVEL 99 GOTO CLEAN
  4570.           IF ERRORLEVEL 50 GOTO UNPACKMAIL
  4571.           IF ERRORLEVEL 40 GOTO LOCAL
  4572.           IF ERRORLEVEL 33 GOTO LOAD_2400
  4573.           IF ERRORLEVEL 32 GOTO LOAD_1200
  4574.           IF ERRORLEVEL 31 GOTO LOAD_300
  4575.           IF ERRORLEVEL 10 GOTO OUT
  4576.           IF ERRORLEVEL 6  GOTO ERROR6
  4577.           IF ERRORLEVEL 5  GOTO ERROR5
  4578.           IF ERRORLEVEL 4  GOTO ERROR4
  4579.           IF ERRORLEVEL 3  GOTO ERROR3
  4580.           IF ERRORLEVEL 2  GOTO ERROR2
  4581.           IF ERRORLEVEL 1  GOTO ERROR1
  4582.           GOTO START
  4583.         :LOAD_300
  4584.           QUICKBBS -B300 -E0
  4585.           GOTO START
  4586.         :LOAD_1200
  4587.           QUICKBBS -B1200 -E0
  4588.           GOTO START
  4589.         :LOAD_2400
  4590.           QUICKBBS -B2400 -E0
  4591.           GOTO START
  4592.         :LOCAL
  4593.           QUICKBBS -L -E0
  4594.           GOTO START
  4595.  
  4596.         :CLEAN
  4597.         rem Message Areas Maintenance
  4598.           IMTHINGS KILL /D10 /N50
  4599.           IMTHINGS PACK
  4600.           GOTO START
  4601.  
  4602.  
  4603.  
  4604.  
  4605.  
  4606.  
  4607.     ┌─────────────────────────────────────────────────────────────────────┐
  4608.     └── (C) Fabiano Fabris ───────────────────────────────────────── 66 ──┘
  4609.  
  4610.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4611.     └─────────────────────────────────────────────────────────────────────┘
  4612.  
  4613.  
  4614.  
  4615.  
  4616.         :UNPACKMAIL
  4617.           IMAIL TOSS
  4618.           IMAIL PACK 24:all 25:all 26:all via 27:27/1
  4619.           GOTO START
  4620.  
  4621.         :ERROR1
  4622.           CLS
  4623.           ECHO *** Internal Error ***   Programming Error
  4624.           GOTO OUT
  4625.         :ERROR2
  4626.           CLS
  4627.           ECHO *** External Error ***    Missing File
  4628.           GOTO OUT
  4629.         :ERROR3
  4630.           CLS
  4631.           ECHO *** Insufficient Disk Space ***
  4632.           GOTO OUT
  4633.         :ERROR4
  4634.           CLS
  4635.           ECHO *** Modem not Responding ***
  4636.           GOTO OUT
  4637.         :ERROR5
  4638.           CLS
  4639.           ECHO *** Unable to Init Modem ***
  4640.           GOTO OUT
  4641.         :ERROR6
  4642.           CLS
  4643.           ECHO *** FOSSIL Error ***
  4644.         :OUT
  4645.            ECHO System .... Down!
  4646.  
  4647.  
  4648.  
  4649.  
  4650.  
  4651.  
  4652.  
  4653.  
  4654.  
  4655.  
  4656.  
  4657.  
  4658.  
  4659.  
  4660.  
  4661.  
  4662.  
  4663.  
  4664.  
  4665.  
  4666.  
  4667.  
  4668.  
  4669.  
  4670.  
  4671.     ┌─────────────────────────────────────────────────────────────────────┐
  4672.     └── (C) Fabiano Fabris ───────────────────────────────────────── 67 ──┘
  4673.  
  4674.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4675.     └─────────────────────────────────────────────────────────────────────┘
  4676.  
  4677.  
  4678.  
  4679.  
  4680.      13. MISCELLANEOUS INFORMATION
  4681.  
  4682.  
  4683.         a. Files Maintained by IMAIL
  4684.  
  4685.            IMAIL and  IMSETUP create  and  maintain several  external  data
  4686.            files. Generally it is  NOT a good idea  to delete these  unless
  4687.            you wish to rebuild your configuration from the beginning.
  4688.  
  4689.            Of these  files,  all  those  containing  IMAIL's  configuration
  4690.            information (ie, all those whose name begins with IMAIL)  should
  4691.            reside in the directory from which IMAIL is run, or, if you have
  4692.            set the IMAIL environment variable,  in the directory it  points
  4693.            to.
  4694.  
  4695.               IMAIL.CF       Basic   IMAIL    configuration    information,
  4696.                              including network addresses, Pack Routing  and
  4697.                              so on.
  4698.  
  4699.               IMAIL.AR       Contains the definitions of the echo areas. If
  4700.                              this  file   is   deleted,   ALL   echo   area
  4701.                              information will be lost. This file is updated
  4702.                              by AreaLink,  if  necessary,  and  is  usually
  4703.                              maintained via IMSETUP.
  4704.  
  4705.               IMAIL.AX       Index file of the echo area information.  This
  4706.                              file is maintained and updated both by IMSETUP
  4707.                              and IMAIL. It  may be deleted  (in which  case
  4708.                              IMSETUP will recreate it),  but all echo  mail
  4709.                              statistics information will be lost.
  4710.  
  4711.               IMAIL.ND       This file contains the information defined  in
  4712.                              the Node Manager.
  4713.  
  4714.               IMAIL.DP       Data  base  of   information  used  to   catch
  4715.                              duplicate messages. This file may be  deleted,
  4716.                              but then you risk missing incoming dupes.
  4717.  
  4718.               IMAIL.NE       Created when  unknown  echos  arrive  at  your
  4719.                              system, or  when  a Forward  Link  Request  is
  4720.                              generated. After running IMSETUP, this file is
  4721.                              deleted.
  4722.  
  4723.               ????????.$I$   A packet  file (????????.PKT)  that was  being
  4724.                              processed by TOSS. You should only find  these
  4725.                              files if  there was  a system  crash during  a
  4726.                              TOSS. In order to process it, simply run IMAIL
  4727.                              TOSS again.
  4728.  
  4729.  
  4730.  
  4731.  
  4732.  
  4733.  
  4734.  
  4735.     ┌─────────────────────────────────────────────────────────────────────┐
  4736.     └── (C) Fabiano Fabris ───────────────────────────────────────── 68 ──┘
  4737.  
  4738.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4739.     └─────────────────────────────────────────────────────────────────────┘
  4740.  
  4741.  
  4742.  
  4743.  
  4744.         b. Exit Codes
  4745.  
  4746.            Should an error occur while IMAIL or IMTHINGS are running,  both
  4747.            programs will exit with an error, and set the MS-DOS  ERRORLEVEL
  4748.            environment variable. This may  be tested in  a batch file,  and
  4749.            acted upon. Listed below are  the ERRORLEVELs returned by  IMAIL
  4750.            and IMTHINGS.
  4751.  
  4752.              ERRORLEVEL          Meaning
  4753.              0                   No error
  4754.              1                   IMAIL TOSS processed net mail
  4755.              2                   IMAIL TOSS imported echo mail
  4756.              243                 Command line parameter error
  4757.              244                 IMAIL.CF not found
  4758.              245                 IMAIL.AR not found
  4759.              246                 IMAIL.ND not found
  4760.              247                 Error opening file
  4761.              248                 Error reading file
  4762.              249                 Error writing file
  4763.              250                 Error in IMAIL.CF
  4764.              251                 Bad version of IMAIL.CF
  4765.              252                 File not found
  4766.              253                 Memory allocation error
  4767.              254                 Insufficient disk space
  4768.              255                 Unknown error
  4769.  
  4770.  
  4771.  
  4772.  
  4773.  
  4774.  
  4775.  
  4776.  
  4777.  
  4778.  
  4779.  
  4780.  
  4781.  
  4782.  
  4783.  
  4784.  
  4785.  
  4786.  
  4787.  
  4788.  
  4789.  
  4790.  
  4791.  
  4792.  
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.  
  4799.     ┌─────────────────────────────────────────────────────────────────────┐
  4800.     └── (C) Fabiano Fabris ───────────────────────────────────────── 69 ──┘
  4801.  
  4802.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4803.     └─────────────────────────────────────────────────────────────────────┘
  4804.  
  4805.  
  4806.  
  4807.  
  4808.      14. IMAIL DISTRIBUTION SITES
  4809.  
  4810.  
  4811.         a. Registration Sites
  4812.  
  4813.  
  4814.            1) Headquarters
  4815.  
  4816.               Intuition / SIGnet Zone 27 Administration
  4817.  
  4818.                  System:                        SIGnet   27:27/0
  4819.                  1200/2400 CM/MO                         27:1339/103
  4820.                  +39-427-938827                 FidoNet  2:230/41.22
  4821.  
  4822.                  Snail Mail:                    Fabiano Fabris
  4823.                                                 Via Zardini 19
  4824.                                                 33090 Sequals (PN)
  4825.                                                 Italy
  4826.  
  4827.  
  4828.            2) Europe
  4829.  
  4830.               IMAIL Support & Distribution Europe
  4831.  
  4832.                  System:                        SIGnet   27:27/100
  4833.                  9600 HST CM                             27:1331/4000
  4834.                  +31-10-4151910                 FidoNet  2:285/503
  4835.  
  4836.                  Snail mail:                    Maurice Leeflang
  4837.                                                 W. de Zwijgerstraat 37-A
  4838.                                                 3043 VB Rotterdam
  4839.                                                 The Netherlands
  4840.  
  4841.  
  4842.            3) North America
  4843.  
  4844.               IMAIL Support & Distribution N.A.
  4845.  
  4846.                  System:                        SIGnet   24:24/7777
  4847.                  9600 HST CM                             24:24/0
  4848.                  +1-604-421-1721                FidoNet  1:153/1025
  4849.                                                 EGGnet   99:99/25
  4850.  
  4851.                  Snail mail:                    Jamie Penner
  4852.                                                 c/o Modern Electronics
  4853.                                                 293 East 11th Avenue
  4854.                                                 Vancouver, BC
  4855.                                                 Canada  V5T 2C4
  4856.  
  4857.  
  4858.  
  4859.  
  4860.  
  4861.  
  4862.  
  4863.     ┌─────────────────────────────────────────────────────────────────────┐
  4864.     └── (C) Fabiano Fabris ───────────────────────────────────────── 70 ──┘
  4865.  
  4866.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4867.     └─────────────────────────────────────────────────────────────────────┘
  4868.  
  4869.  
  4870.  
  4871.  
  4872.         b. Support Sites
  4873.  
  4874.  
  4875.            1) Austria
  4876.  
  4877.                  Andreas Levenitschnig          SIGnet   27:1343/1
  4878.                                                 FidoNet  2:2/527
  4879.  
  4880.  
  4881.            2) Sweden
  4882.  
  4883.                  Andreas Birgerson              SIGnet   27:4346/200
  4884.                                                 FidoNet  2:200/407
  4885.  
  4886.  
  4887.            3) Switzerland
  4888.  
  4889.                  Roger Mella                    FidoNet  2:300/682
  4890.  
  4891.  
  4892.            4) U.S.A.
  4893.  
  4894.                  Jim Louvau                     SIGnet   26:26/102
  4895.                                                          26:1515/5
  4896.                                                 FidoNet  1:290/4
  4897.  
  4898.  
  4899.  
  4900.  
  4901.  
  4902.  
  4903.  
  4904.  
  4905.  
  4906.  
  4907.  
  4908.  
  4909.  
  4910.  
  4911.  
  4912.  
  4913.  
  4914.  
  4915.  
  4916.  
  4917.  
  4918.  
  4919.  
  4920.  
  4921.  
  4922.  
  4923.  
  4924.  
  4925.  
  4926.  
  4927.     ┌─────────────────────────────────────────────────────────────────────┐
  4928.     └── (C) Fabiano Fabris ───────────────────────────────────────── 71 ──┘
  4929.  
  4930.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4931.     └─────────────────────────────────────────────────────────────────────┘
  4932.  
  4933.  
  4934.  
  4935.  
  4936.                                   ══ INDEX ══
  4937.  
  4938.  
  4939.     Area Line, 55                        IMTHINGS KILL, 42
  4940.     Area Manager                         IMTHINGS MOVE, 45
  4941.      # Days, 21                          IMTHINGS PACK, 46
  4942.      # Messages, 22                      IMTHINGS POST, 47
  4943.      Active Status, 19                   IMTHINGS RECOVER, 49
  4944.      Area Comment, 19                    IMTHINGS SEND, 49
  4945.      Area Name, 19                       IMTHINGS SORT, 52
  4946.      Board Number, 20                   Compressing Message Base, 44,46
  4947.      Export List, 23                    Configuration Files
  4948.      Group, 21                           IMAIL.AR, 68
  4949.      Keep Seens, 21                      IMAIL.AX, 68
  4950.      Origin Address, 22                  IMAIL.CF, 68
  4951.      Origin Line, 20                     IMAIL.ND, 68
  4952.      Passthrough Areas, 20              Cross-linked Areas, 19,20,55
  4953.      Secure Mode, 20                    Cross-linked messages, 47
  4954.      SEEN-BY Addresses, 22
  4955.      Tiny Seens, 21                     Deleting Messages Sel, 21,22,42
  4956.      XRS Address, 22                    Direct ARCmail, 24
  4957.     AreaLink, 35                        Domain Names, 8
  4958.      Forward Link Requests, 38          Dupe Message Board, 11
  4959.      Invoking, 30,34
  4960.      Meta-Commands, 36                  Echo Gating, 59
  4961.      Remote Maintainance, 24,37         Echo Mail
  4962.      Replies, 38                         Area Name, 55
  4963.      Request Format, 35                  Control Information, 55
  4964.     AreaLink Meta-Commands, 36           Gating, 59
  4965.      ALL, 36                             How it Works, 54
  4966.      FROM, 37                            How Sent, 57
  4967.      LIST, 37                            Origin Line, 56
  4968.      QUERY, 37                           PATH Lines, 56
  4969.      RESCAN, 36,37                       SEEN-BY Lines, 56
  4970.     AreaLink Options                     Tear Line, 55
  4971.      Allow Rescan, 12                    Topology, 57
  4972.      Forward Link Requests, 12           What is it?, 54
  4973.      Keep Receipt, 12                   Echo Statistics, 52
  4974.     Areas.Bbs                           Environment variable, 2,5,7,68
  4975.      Export to, 28                      ERRORLEVELS, 69
  4976.      Import from, 26                     IMAIL TOSS, 29,69
  4977.     Automatic Message Replies, 39       Exporting Net Mail, 41
  4978.  
  4979.     Bad Message Board, 11,13,30,34      Fakenet Addresses, 8
  4980.                                         Fakenets
  4981.     Command Line Options                 and Pack Routing, 33
  4982.      IMAIL, 29                          FLAGS Kludge
  4983.      IMAIL PACK, 31                      CFM, 64
  4984.      IMAIL SCAN, 30                      DIR, 63
  4985.      IMAIL TOSS, 29                      IMM, 64
  4986.      IMSETUP, 7                          KFS, 64
  4987.  
  4988.  
  4989.  
  4990.  
  4991.     ┌─────────────────────────────────────────────────────────────────────┐
  4992.     └── (C) Fabiano Fabris ───────────────────────────────────────── 72 ──┘
  4993.  
  4994.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  4995.     └─────────────────────────────────────────────────────────────────────┘
  4996.  
  4997.  
  4998.  
  4999.  
  5000.      RRQ, 64                             EID, 62
  5001.      TFS, 64                             FLAGS, 63
  5002.     Forward Link Requests, 12,38,68      FMPT, 62
  5003.                                          INTL, 61
  5004.     IMAIL                                MSGID, 62
  5005.      ALNK, 34                            PATH, 56,59
  5006.      Exit Codes, 69                      PID, 63
  5007.      PACK, 31                            REPLY, 63
  5008.      SCAN, 30                            TOPT, 61
  5009.      TOSS, 29
  5010.     IMAIL Robot, 49                     Linking the Message Base, 44
  5011.     IMAIL.AR, 68                        Log Files
  5012.     IMAIL.AX, 68                         Echo Statistics, 10,52
  5013.     IMAIL.CF, 68                         IMAIL, 9
  5014.     IMAIL.DP, 68                         Log Level, 10
  5015.     IMAIL.ND, 68
  5016.     IMAIL.NE, 34,38,68                  Message Area Rescans, 12,37
  5017.     Importing Net Mail, 42              Moving Message Areas, 45
  5018.     IMSETUP                             MSGID Kludge, 62
  5019.      AreaLink options, 11               MSGID Kludges, 8
  5020.      Compression programs, 16
  5021.      Decompression programs, 16         Net Mail Board, 10
  5022.      Domain names, 8                    Net Mail Message Subdirectory, 9
  5023.      Echo areas, 17                     Networks, 6
  5024.      General Configuration, 7           New Echo Areas, 34,38,68
  5025.      Import/export, 26                  Node Manager
  5026.      Node Manager, 23                    Address, 23
  5027.      Other parameters, 13                Capability, 25
  5028.      Pack routing, 25                    Direct, 24
  5029.      Subdirectories, 8                   Groups, 23
  5030.      System addresses, 7                 Password, 23
  5031.     IMTHINGS, 41                         Program, 24
  5032.      EXPORT, 41                          Remote Maintainance, 24
  5033.      IMPORT, 42                          Status, 24
  5034.      INDEX, 42                          Notifying of Linked Echos, 46
  5035.      KILL, 42
  5036.      MOVE, 45                           Origin Line, 20,56
  5037.      NOTIFY, 46                         Outbound Subdirectory, 9
  5038.      PACK, 46
  5039.      POST, 47                           PACK Switches
  5040.      RECOVER, 49                         Crash Messages, 33
  5041.      SEND, 49                            Hold Messages, 33
  5042.      SORT, 52                            No Default Pack Routing, 33
  5043.      STAT, 52                           Packet Compression, 34
  5044.     Inbound Subdirectory, 9             Packing Net Mail Messages, 31
  5045.     Installation, 5                     PATH Lines, 56
  5046.     INTHINGS                            Points
  5047.      LINK, 44                            and Pack Routing, 26,31,32
  5048.                                          Fakenet addresses, 8
  5049.     Kludges, 61                          SEEN-BYs & PATHs, 22
  5050.  
  5051.  
  5052.  
  5053.  
  5054.  
  5055.     ┌─────────────────────────────────────────────────────────────────────┐
  5056.     └── (C) Fabiano Fabris ───────────────────────────────────────── 73 ──┘
  5057.  
  5058.     ┌── IMAIL 1.10 ───────────────────────────────────────────────────────┐
  5059.     └─────────────────────────────────────────────────────────────────────┘
  5060.  
  5061.  
  5062.  
  5063.  
  5064.     Posting Messages in a Board, 47      Net Mail, 9
  5065.                                          Outbound Files, 9
  5066.     QBBS/RA System Subdirectory, 9       QBBS/RA System, 9
  5067.                                         System Addresses, 7
  5068.     Rebuilding Index Files, 42          System Requirements
  5069.     Recovering Deleted Messages, 49      Hardware, 5
  5070.                                          Software, 5
  5071.     SCAN Switches
  5072.      No Default Pack Routing, 31        Tear Line, 55
  5073.     Scanning Echo Mail, 30              TOSS Switches
  5074.     SEEN-BY Lines, 22,56                 Check Bad Message Board, 30
  5075.     Sorting the Message Base, 52         No AreaLink, 30
  5076.     Subdirectories, 8                   Tossing Echo Mail, 29
  5077.      Inbound Files, 9
  5078.  
  5079.  
  5080.  
  5081.  
  5082.  
  5083.  
  5084.  
  5085.  
  5086.  
  5087.  
  5088.  
  5089.  
  5090.  
  5091.  
  5092.  
  5093.  
  5094.  
  5095.  
  5096.  
  5097.  
  5098.  
  5099.  
  5100.  
  5101.  
  5102.  
  5103.  
  5104.  
  5105.  
  5106.  
  5107.  
  5108.  
  5109.  
  5110.  
  5111.  
  5112.  
  5113.  
  5114.  
  5115.  
  5116.  
  5117.  
  5118.  
  5119.     ┌─────────────────────────────────────────────────────────────────────┐
  5120.     └── (C) Fabiano Fabris ───────────────────────────────────────── 74 ──┘
  5121.